Click or drag to resize
CMSForm Class
Form engine specific for CMS. It displays the given form.
Inheritance Hierarchy

Namespace: CMS.FormEngine.Web.UI
Assembly: CMS.FormEngine.Web.UI (in CMS.FormEngine.Web.UI.dll) Version: 10.0.0
Syntax
C#
public class CMSForm : BasicForm

The CMSForm type exposes the following members.

Constructors
  NameDescription
Public methodCMSForm
Constructor.
Top
Fields
  NameDescription
Protected fieldcategoryListPanel
Category list panel, may be displayed above formPanel.
(Inherited from BasicForm.)
Protected fieldcategoryListPlaceholder
Placeholder for category list.
(Inherited from BasicForm.)
Protected fieldmDefaultPageTemplateID
Default page template ID.
Protected fieldmDocumentManager
Document manager.
Protected fieldmMessagesPlaceHolder
Messages placeholder
Protected fieldmOwnerID
Owner ID.
Protected fieldmShowPrivateFields
Nonpublic fields are shown if true.
(Inherited from BasicForm.)
Protected fieldmSubmitButton
Form submit button.
(Inherited from BasicForm.)
Protected fieldmSubmitImageButton
Form submit image button.
(Inherited from BasicForm.)
Top
Properties
  NameDescription
Public propertyAdditionalData
Gets a dictionary that provides additional context data for form controls.
(Inherited from BasicForm.)
Public propertyAllowEditVisibility
Indicates if field visibility could be edited.
(Inherited from BasicForm.)
Public propertyAllowExternalEditing
Indicates if external editing should be allowed for the controls.
(Inherited from BasicForm.)
Public propertyAllowMacroEditing
Determines whether to display the "Edit value" button in EditingFormControls.
(Inherited from BasicForm.)
Public propertyAllowModeSwitch
Determines whether to allow mode switching (simple <-> advanced).
(Inherited from BasicForm.)
Public propertyAllowSpellCheck
Indicates if spell check is allowed. Not allowed by default.
(Inherited from AbstractBasicForm.)
Public propertyAlternativeFormFullName
Alternative form full name (ClassName.AlternativeFormName).
Public propertyAltFormInformation
Alternative form information.
(Inherited from BasicForm.)
Public propertyApplyVisibility
Indicates if field visibility should be applied.
(Inherited from BasicForm.)
Public propertyAssociatedControls
Controls associated with FormItems.
(Inherited from BasicForm.)
Public propertyAutomaticLabelWidth
Set width of all labels according to the widest label. This property is applied only if DefaultFormLayout is set to Divs.
(Inherited from BasicForm.)
Protected propertyClassInfo
DataClassInfo of edited object.
(Inherited from BasicForm.)
Public propertyCollapseCategoryImageUrl
Image URL for collapsing a category.
(Inherited from BasicForm.)
Public propertyComponentName
Component name.
Public propertyContextResolver
Form context resolver.
(Inherited from BasicForm.)
Public propertyControlContext
Gets the current control context.
(Inherited from AbstractBasicForm.)
Public propertyCopyDefaultDataFromDocumentId
Optional DocumentId of the document that should be used as a template with default values.
Public propertyCultureCode
Culture code.
Public propertyCustomTimeZone
Gets or sets custom time zone info. This time zone is used when TimeZoneType is 'custom'.
(Inherited from AbstractBasicForm.)
Public propertyData
Data to be edited.
(Inherited from AbstractBasicForm.)
Public propertyDataRow
Data to be edited.
(Inherited from AbstractBasicForm.)
Public propertyDefaultCategoryName
Default category name.
(Inherited from BasicForm.)
Public propertyDefaultFieldLayout
Default field layout.
(Inherited from BasicForm.)
Public propertyDefaultFormLayout
Form layout.
(Inherited from BasicForm.)
Public propertyDefaultPageTemplateID
Default page template ID.
Protected propertyDefaultValidationErrorMessage
Default validation error message.
(Overrides BasicFormDefaultValidationErrorMessage.)
Public propertyDialogParameters
Additional parameters for the dialog windows.
(Inherited from BasicForm.)
Public propertyDisplayContext
Gets or sets the current display context which is used if control contains DisplayIn value.
(Inherited from BasicForm.)
Public propertyDocumentID
Specifies together with CultureCode edited node.
Public propertyDocumentManager
Document manager control
Public propertyEditedObject
Edited object. TreeNode in CMSForm, IDataClass in BizForm and CustomTableForm, AbstractInfo or DataClassInfo in DataForm.
(Inherited from BasicForm.)
Public propertyEnabled
Indicates if the form control is enabled.
(Inherited from BasicForm.)
Public propertyEnsureFirstLetterUpperCase
If true, labels of the controls are processed to have the first letter upper case.
(Inherited from BasicForm.)
Public propertyErrorLabel
Label for the errors.
(Overrides BasicFormErrorLabel.)
Public propertyExpandCategoryImageUrl
Image URL for expanding a category.
(Inherited from BasicForm.)
Public propertyExplanationTextCssClass
CSS class that is added to container that is wrapping content after text (only if content before text is empty). Default value is "ExplanationText".
(Inherited from BasicForm.)
Public propertyFieldActionsControls
Contains FieldActions controls if the form is in design mode (BasicForm.IsDesignMode property).
(Inherited from AbstractBasicForm.)
Public propertyFieldCaptionCellCssClass
CSS class for the individual field label cell.
(Inherited from BasicForm.)
Public propertyFieldCaptionCssClass
CSS class for the individual field label.
(Inherited from BasicForm.)
Public propertyFieldControls
Dictionary with FormEngineUserControl objects.
(Inherited from AbstractBasicForm.)
Public propertyFieldCssClass
CSS class for the whole field (usually row).
(Inherited from BasicForm.)
Public propertyFieldEditingControls
Dictionary with EditingFormControl objects.
(Inherited from AbstractBasicForm.)
Public propertyFieldErrorCellCssClass
CSS class for the individual field error label cell.
(Inherited from BasicForm.)
Public propertyFieldErrorCssClass
CSS class that is added to editing form control after its validation failed. Default value is "Error".
(Inherited from BasicForm.)
Public propertyFieldErrorLabelCssClass
CSS class for the individual field error label.
(Inherited from BasicForm.)
Public propertyFieldErrorLabels
FieldErrorLabels.
(Inherited from AbstractBasicForm.)
Public propertyFieldGroupCaptionCssClass
CSS class for the field group caption.
(Inherited from BasicForm.)
Public propertyFieldGroupCssClass
CSS class for the whole field group.
(Inherited from BasicForm.)
Public propertyFieldGroupHeadingIsAnchor
Gets or sets a value indicating whether heading for the field group caption is anchor.
(Inherited from BasicForm.)
Public propertyFieldGroupHeadingLevel
Heading level for the field group caption.
(Inherited from BasicForm.)
Public propertyFieldLabels
FieldLabels.
(Inherited from AbstractBasicForm.)
Public propertyFields
List of field names in order they appear in the form.
(Inherited from AbstractBasicForm.)
Public propertyFieldsToHide
List of fields to hide (empty by default).
(Inherited from BasicForm.)
Public propertyFieldUpdatePanels
Contains update panels which surround the fields (whole rows including labels) if the form is in design mode (BasicForm.IsDesignMode property).
(Inherited from AbstractBasicForm.)
Public propertyFieldValueCellCssClass
CSS class for the individual field control cell.
(Inherited from BasicForm.)
Public propertyFieldVisibilityCellCssClass
CSS class for the individual field visibility cell.
(Inherited from BasicForm.)
Public propertyFieldVisibilityControls
Visibility controls hashtable.
(Inherited from AbstractBasicForm.)
Public propertyFieldVisibilityCssClass
CSS class for the individual field visibility control.
(Inherited from BasicForm.)
Public propertyFirstField
First field element.
(Inherited from BasicForm.)
Public propertyForceReloadCategories
Forces categories to get to default collapsed state.
(Inherited from BasicForm.)
Public propertyFormButtonCssClass
CSS class for the form button.
(Inherited from BasicForm.)
Public propertyFormButtonPanel
Returns panel surrounding submit button if generated by automatic layouts, otherwise returns null.
(Inherited from BasicForm.)
Public propertyFormButtonPanelCssClass
CSS class for the form button panel.
(Inherited from BasicForm.)
Public propertyFormCssClass
CSS class which will be used to wrap form control.
(Inherited from BasicForm.)
Protected propertyFormDefaultStyle
Default form-specific style configuration.
(Inherited from BasicForm.)
Public propertyFormGUID
Identifies the instance of form.
(Inherited from BasicForm.)
Public propertyFormInformation
Form information.
(Inherited from BasicForm.)
Public propertyFormLayout
Definition of the form layout.
(Inherited from BasicForm.)
Public propertyFormLayoutType
Form layout type.
(Inherited from BasicForm.)
Public propertyFormMode
Form mode - insert or update.
Public propertyFormName
Form name in form application.class.form.
Public propertyFormPanel
Returns form outer panel.
(Inherited from BasicForm.)
Public propertyFormPrefix
Form name prefix. If set, form with name in format [FormPrefix][form name] is searched instead of [form name].
Public propertyFormType
Indicates in what control is this basic form used.
(Inherited from BasicForm.)
Public propertyGroupCssClass
CSS class for the whole field group with heading.
(Inherited from BasicForm.)
Public propertyGroupID
Group ID.
Public propertyHideSystemFields
If true, system fields are hidden.
(Inherited from BasicForm.)
Public propertyHtmlAreaToolbar
HTML editor toolbar set name.
(Inherited from BasicForm.)
Public propertyHtmlAreaToolbarLocation
HTML editor toolbar location.
(Inherited from BasicForm.)
Public propertyCheckFieldEmptiness
Indicates that field should be checked on emptiness in validation step by BasicForm. Default TRUE. It is preferable to set to FALSE for controls with complex input such as filter form.
(Inherited from BasicForm.)
Public propertyInfoLabel
Information label.
(Overrides BasicFormInfoLabel.)
Public propertyInitCompleted
If true, the initialization of the control has already completed and won't repeat. Set to true in your initialization code.
(Inherited from CMSDynamicWebControl.)
Protected propertyInitEarly
If true, the control initializes on BeforeInitComplete, otherwise on InitComplete event.
(Inherited from CMSDynamicWebControl.)
Public propertyIsDesignMode
Determines whether the form is in design mode.
(Inherited from BasicForm.)
Public propertyIsFirstLoad
Indicates if inner controls are loaded for the first time (the form may be initialized on a postback).
(Inherited from BasicForm.)
Public propertyIsInsertMode
Indicates if the control is used for inserting a new object.
(Inherited from AbstractBasicForm.)
Public propertyIsLiveSite
Indicates if control is used on live site.
(Inherited from CMSWebControl.)
Public propertyIsSimpleMode
Returns if the form is in simple or advanced mode. Depends on AllowModeSwitch property.
(Inherited from BasicForm.)
Public propertyLastField
Last field element.
(Inherited from BasicForm.)
Public propertyLayout
Layout of the form
(Inherited from BasicForm.)
Public propertyLayoutTemplate
Layout template, if set, the given layout is used.
(Inherited from BasicForm.)
Public propertyMacroTable
Hashtable with IsMacro flags.
(Inherited from BasicForm.)
Public propertyMarkRequiredFields
If true, required field labels are marked with resource string.
(Inherited from BasicForm.)
Public propertyMessagesPlaceHolder
Messages placeholder.
(Overrides BasicFormMessagesPlaceHolder.)
Public propertyMode
Gets or sets the mode of the form.
(Inherited from AbstractBasicForm.)
Public propertyNode
Document node.
Public propertyNodeID
Specifies together with CultureCode edited node.
Public propertyOwnerID
Owner ID.
Public propertyParentNodeID
Parent node ID. Indicates parent node for document insertion.
Public propertyParentObject
Parent node of currently edited/inserted node
Public propertyProcessDisabledFields
Indicates if disabled fields should be processed (validated and saved). Default value is true in insert mode and false in edit mode.
(Inherited from AbstractBasicForm.)
Public propertyRedirectUrlAfterSave
URL to which the form redirects after successful save.
(Inherited from BasicForm.)
Public propertyResolverName
Gets or sets macro resolver name.
(Inherited from BasicForm.)
Public propertySetDefaultValuesToDisabledFields
If true, default values will be set to the disabled fields. Default value is true in insert mode and false in edit mode.
(Inherited from BasicForm.)
Public propertyShortID
Short ID of the control.
(Inherited from CMSWebControl.)
Public propertyShowImageButton
Show image button flag.
(Inherited from BasicForm.)
Public propertyShowOkButton
Indicates if button OK should be displayed.
Public propertyShowPrivateFields
Indicates whether to show private fields or not.
(Inherited from BasicForm.)
Public propertyShowValidationErrorMessage
Indicates if error message should be displayed after validation failed.
(Inherited from BasicForm.)
Public propertySiteName
Current SiteName.
(Inherited from BasicForm.)
Public propertySpellCheckFields
List with client Ids of fields that should be spell checked.
(Inherited from AbstractBasicForm.)
Public propertyStopProcessing
Indicates if processing of the code of this control should continue. It can be used after raising an event.
(Inherited from CMSDynamicWebControl.)
Public propertySubmitButton
Form submit button.
(Inherited from BasicForm.)
Public propertySubmitImageButton
Form submit image button.
(Inherited from BasicForm.)
Protected propertyTagKey
Overrides the generation of the SPAN tag with custom tag.
(Inherited from BasicForm.)
Public propertyTimeZoneType
Gets or sets time zone type for child controls. Default value is TimeZoneTypeEnum.Inherit.
(Inherited from AbstractBasicForm.)
Public propertyTreeProvider
Tree provider instance. If it's not provided, it's created automatically.
Public propertyUIContext
Control's UI Context
(Inherited from BasicForm.)
Public propertyUseColonBehindLabel
If true, colon(:) is placed behind field label.
(Inherited from BasicForm.)
Public propertyValidationErrorMessage
Optional error message displayed after validation failed.
(Inherited from BasicForm.)
Public propertyVisibilityFormName
This name is used if ApplyVisibility is 'true' to get visibility definition of current user.
(Inherited from BasicForm.)
Top
Methods
  NameDescription
Public methodAddConfirmation
Adds confirmation text to existing message on the page, optionally with a tooltip text.
(Inherited from BasicForm.)
Protected methodAddControlsAfterInternal
Allows to add additional components after the form.
(Overrides BasicFormAddControlsAfterInternal.)
Protected methodAddControlsBeforeInternal
Allows to add additional components before the form.
(Overrides BasicFormAddControlsBeforeInternal.)
Public methodAddError
Adds error text to existing message on the page.
(Inherited from BasicForm.)
Public methodAddInformation
Adds information text to existing message on the page.
(Inherited from BasicForm.)
Public methodAddWarning
Adds warning text to existing message on the page.
(Inherited from BasicForm.)
Protected methodAfterSaveActionsInternal
Performs additional actions after save (redirecting or displaying info message).
(Inherited from BasicForm.)
Protected methodCMSForm_OnAfterDataLoad
OnAfterDataReload event handler.
Protected methodConnectAssociatedControls
Connects associated controls (labels and inputs) together, for accessibility and other reasons.
(Inherited from BasicForm.)
Protected methodCreateChildControls
Renders the control at run-time.
(Inherited from CMSDynamicWebControl.)
Protected methodCreateMessagesPlaceHolder
Creates local messages placeholder.
(Overrides BasicFormCreateMessagesPlaceHolder.)
Public methodDisplayErrorLabel
Displays error label.
(Inherited from BasicForm.)
Protected methodEnsureInitialization
Initializes the control. Is called within InitComplete or
(Inherited from CMSDynamicWebControl.)
Protected methodEnsureLabels
Ensures the general labels on the form.
(Inherited from BasicForm.)
Public methodEnsureMessagesPlaceholder
Ensures correct set the messages placeholder.
(Inherited from BasicForm.)
Protected methodGetClassName
Extracts class name from the form name.
Public methodGetDataValue
Returns DataRow value for the specified column.
(Inherited from AbstractBasicForm.)
Public methodGetFieldValue
Gets the value of a specified field.
(Inherited from BasicForm.)
Public methodGetMultifieldValues
Gets the multi-field values of a specified field.
(Inherited from BasicForm.)
Public methodGetWhereCondition
Gets where condition from all form engine user controls.
(Inherited from BasicForm.)
Protected methodHandleFieldsValues
Initializes values for invisible fields.
(Inherited from BasicForm.)
Protected methodInitFormInternal
Initializes the form.
(Overrides BasicFormInitFormInternal.)
Protected methodInitializeControl
Initializes the form.
(Inherited from BasicForm.)
Protected methodInitializeMainPanel
Initializes main form container.
(Inherited from BasicForm.)
Protected methodInitResolver
Initializes macro resolver data sources.
(Overrides BasicFormInitResolver.)
Protected methodInitSpellCheck
Initializes the spell checker.
(Inherited from AbstractBasicForm.)
Public methodIsAnyFieldVisible
Returns TRUE if basic form displays any control.
(Inherited from BasicForm.)
Public methodIsCategoryCollapsed
Returns true if the given category is collapsed
(Inherited from BasicForm.)
Public methodIsFieldAvailable
Checks if control is included in editing controls hashtable.
(Inherited from BasicForm.)
Public methodIsFieldVisible
Checks if the given field is evaluated as visible.
(Inherited from BasicForm.)
Public methodItemChanged
Checks if item has changed.
(Inherited from AbstractBasicForm.)
Protected methodlayout_OnAfterRegisterFormControl
Event after control has been registered in template layout.
(Inherited from BasicForm.)
Public methodLoadControlValues
Loads the values from the data container to the form controls.
(Inherited from AbstractBasicForm.)
Public methodLoadData(DataRow)
Renders form and sets field values.
(Inherited from BasicForm.)
Public methodLoadData(IDataContainer)
Renders form and sets field values.
(Inherited from BasicForm.)
Protected methodLoadDefaultLayout
Loads default layout.
(Inherited from BasicForm.)
Public methodLoadForm
Loads the child controls at run-time.
Protected methodLoadFormLayout
Loads form layout.
(Inherited from BasicForm.)
Protected methodLoadLayout
Loads the form layout.
(Inherited from BasicForm.)
Protected methodLoadTemplateLayout
Loads the layout template.
(Inherited from BasicForm.)
Protected methodLoadViewState
Customized LoadViewState.
(Inherited from CMSDynamicWebControl.)
Protected methodOnInit
OnInit event
(Overrides CMSDynamicWebControlOnInit(EventArgs).)
Protected methodOnLoad
Load event handler.
(Inherited from CMSDynamicWebControl.)
Protected methodOnPreRender
OnPreRender event
(Overrides BasicFormOnPreRender(EventArgs).)
Protected methodPage_InitComplete
Event handler of page's init complete.
(Inherited from CMSDynamicWebControl.)
Public methodPrependError
Prepends error text to existing message on the page.
(Inherited from BasicForm.)
Protected methodProcessContextVisibility
Changes fields' visible attribute according to display context.
(Inherited from BasicForm.)
Protected methodProcessUserVisibility
Changes fields' visible attribute according to user visibility settings or changes form definition if visibility can be edited.
(Inherited from BasicForm.)
Protected methodProcessVisibility
Changes fields' visible attribute according to visibility.
(Inherited from BasicForm.)
Public methodRaiseOnAfterSave
Raises the OnAfterSave event.
(Inherited from BasicForm.)
Public methodRaiseOnBeforeRedirect
Raises the OnBeforeRedirect event.
(Inherited from BasicForm.)
Public methodRaiseOnDeleteFile
Raises the OnDeleteFile event.
(Inherited from BasicForm.)
Protected methodRaiseOnCheckPermissions
Invokes OnCheckPermissions event.
(Inherited from BasicForm.)
Public methodRaiseOnSaveFailed
Raises the OnSaveFailed event.
(Inherited from BasicForm.)
Public methodRaiseOnUploadFile
Raises the OnUploadFile event.
(Inherited from BasicForm.)
Public methodReloadData
Reloads the form data.
(Inherited from BasicForm.)
Protected methodRender
Renders the control at design-time.
(Overrides BasicFormRender(HtmlTextWriter).)
Public methodResolveMacros
Resolves the macros within current WebPart context.
(Inherited from BasicForm.)
Public methodSave
Saves document data.
Protected methodSaveControlValue
Saves the control value to the data.
(Inherited from AbstractBasicForm.)
Public methodSaveData
Saves data and optionally redirects user to specified URL.
(Inherited from BasicForm.)
Protected methodSaveDataClick
Saves form data into Data container after the submit button is clicked.
(Inherited from BasicForm.)
Protected methodSaveDataInternal
Saves data to database. It's called after mBasicForm.SaveData().
(Overrides BasicFormSaveDataInternal.)
Protected methodSaveViewState
Customized SaveViewState.
(Inherited from CMSDynamicWebControl.)
Protected methodSetDataValue
Sets value of the given column in the data.
(Inherited from AbstractBasicForm.)
Public methodShowConfirmation
Shows the general changes saved message.
(Inherited from BasicForm.)
Public methodShowError
Shows the specified error message, optionally with a tooltip text.
(Inherited from BasicForm.)
Public methodShowChangesSaved
Shows the general changes saved message.
(Inherited from BasicForm.)
Public methodShowInformation
Shows the given information on the page, optionally with a tooltip text.
(Inherited from BasicForm.)
Public methodShowWarning
Shows the specified warning message, optionally with a tooltip text.
(Inherited from BasicForm.)
Public methodValidateData
Validates the data, returns true if succeeded.
(Inherited from BasicForm.)
Top
Extension Methods
  NameDescription
Public Extension MethodAddCssClass
Adds CSS class to control. If class is already present, than adding is skipped. Class names are case sensitive.
(Defined by ControlsExtensions.)
Public Extension MethodCallHandled
Calls the method handled by the exception handler. If the call doesn't succeed, the problem is reported through parent IExceptionHandler control instead of throwing unhandled exception for the entire page. Returns true, if the call succeeded, otherwise returns false.
(Defined by ControlsExtensions.)
Public Extension MethodGetCssClasses
Returns all CSS classes of control.
(Defined by ControlsExtensions.)
Public Extension MethodGetRenderedHTML
Returns HTML which would be rendered by control to page.
(Defined by ControlsExtensions.)
Public Extension MethodGetString
Gets the string by the specified resource key
(Defined by ControlsExtensions.)
Public Extension MethodHasCssClass
Checks whether the control has given CSS class. Class names are case sensitive.
(Defined by ControlsExtensions.)
Public Extension MethodRemoveCssClass
Removes all occurrences. Class names are case sensitive.
(Defined by ControlsExtensions.)
Public Extension MethodSetCssClasses
Sets CSS classes to the control. Current classes will be overridden.
(Defined by ControlsExtensions.)
Top
Events
  NameDescription
Public eventOnAfterDataLoad
After data load event.
(Inherited from BasicForm.)
Public eventOnAfterSave
After form data save event. It is called during saving process when the form content is successfully saved.
(Inherited from BasicForm.)
Public eventOnAfterValidate
After validation event.
(Inherited from BasicForm.)
Public eventOnBeforeDataLoad
Before data load event.
(Inherited from BasicForm.)
Public eventOnBeforeDataRetrieval
Before form data retrieval event. It is called during saving process after successful validation and before data are retrieved from form controls.
(Inherited from BasicForm.)
Public eventOnBeforeRedirect
Before redirect event (after successful save).
(Inherited from BasicForm.)
Public eventOnBeforeSave
Before form data save event. It is called during saving process after data are retrieved from form controls and can be processed further (e.g. saved to DB).
(Inherited from BasicForm.)
Public eventOnBeforeValidate
Before validation event.
(Inherited from BasicForm.)
Public eventOnDeleteFile
Occurs when the file is deleted.
(Inherited from BasicForm.)
Public eventOnGetControlValue
Occurs when a value is being extracted from a form control.
(Inherited from AbstractBasicForm.)
Public eventOnCheckPermissions
Occurs when permission can be checked. It is called at the beginning of the saving process.
(Inherited from BasicForm.)
Public eventOnItemValidation
Occurs when a field is validated.
(Inherited from BasicForm.)
Public eventOnSaveFailed
Occurs when saving data to the database fails.
(Inherited from BasicForm.)
Public eventOnUploadFile
Occurs when the file is uploaded.
(Inherited from BasicForm.)
Public eventOnValidationFailed
Occurs when validation of the form fails.
(Inherited from BasicForm.)
Top
See Also