Click or drag to resize
UIForm Class
Form control for the admin UI.
Inheritance Hierarchy

Namespace: CMS.FormControls
Assembly: CMS.FormControls (in CMS.FormControls.dll) Version: 8.2.23
Syntax
C#
public class UIForm : BasicForm, IObjectTypeDriven

The UIForm type exposes the following members.

Constructors
  NameDescription
Public methodUIForm
Constructor.
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
Internal method to add components before the form from inherited forms.
(Inherited from BasicForm.)
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
Executes additional actions after successful save.
(Overrides BasicFormAfterSaveActionsInternal(String, Boolean).)
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.
(Inherited from BasicForm.)
Public methodDisplayErrorLabel
Displays error label.
(Inherited from BasicForm.)
Public methodEnableByLockState
Enables or disables form according to current checkout state with respect to current user.
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.)
Public methodGetAttachment
Returns attachment info and raises OnGetAttachment event.
(Inherited from BasicForm.)
Protected methodGetAttachmentInternal
Gets attachment
(Inherited from BasicForm.)
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 default values for invisible fields.
(Inherited from BasicForm.)
Protected methodInitFormInternal
Initializes the form information.
(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.)
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 method.
(Overrides CMSDynamicWebControlOnInit(EventArgs).)
Protected methodOnLoad
Onload method.
(Overrides CMSDynamicWebControlOnLoad(EventArgs).)
Protected methodOnPreRender
OnPreRender method.
(Overrides BasicFormOnPreRender(EventArgs).)
Protected methodPage_InitComplete
Event handler of page's init complete.
(Inherited from CMSDynamicWebControl.)
Protected methodPageHelper_InitComplete
Init complete event handler
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.
(Inherited from BasicForm.)
Public methodResolveMacros
Resolves the macros within current WebPart context.
(Inherited from BasicForm.)
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
Internal method to save data to the database.
(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.)
Protected methodUIForm_OnCheckPermissions
Check permissions event handler.
Protected methodUIForm_OnItemValidation
Fired on the item validation.
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 MethodAsValue
Converts object to a query value which can be used as a query parameter
(Defined by QueryExtensions.)
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 MethodGetAPIString
Gets the string by the specified resource key
(Defined by CoreExtensions.)
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 CoreExtensions.)
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.)
Public Extension MethodToBoolean
Returns the boolean representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDateTime
Returns the DateTime representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDouble
Returns the double representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToGuid
Returns the Guid representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToInteger
Returns the integer representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToString
Returns the string representation of an object or default value if not.
(Defined by CoreExtensions.)
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 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 propertyAlternativeFormName
Gets or sets the name of the alternative form to use.
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 propertyContextResolver
Form context resolver.
(Inherited from BasicForm.)
Public propertyControlContext
Gets the current control context.
(Inherited from AbstractBasicForm.)
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 propertyDefaultValidationErrorMessage
Default validation error message. Shown when ValidationErrorMessage is not set manually.
(Inherited from BasicForm.)
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 propertyDisplayNameChanged
Indicates whether display name of object was changed
Public propertyEditedObject
Edited object.
Public propertyEnabled
Indicates if the form control is enabled.
(Inherited from BasicForm.)
Public propertyEnabledByLockState
Gets or sets a value that indicates if the form enabled state is set automatically based on the lock state of the edited object.
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.
(Inherited from BasicForm.)
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.
(Overrides BasicFormFormDefaultStyle.)
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 propertyFormPanel
Returns form outer panel.
(Inherited from BasicForm.)
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 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.
(Inherited from BasicForm.)
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
Sets simple/advanced mode of basicform.
(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 propertyNewObjectPosition
Gets or sets the position of the newly created object. This applies only to those object which has OrderColumn defined.
Public propertyObjectManager
Gets the object manager control if present on the page.
Public propertyObjectSiteID
Edited object site ID.
Public propertyObjectType
Object type for editing.
Public propertyParentObject
Parent object.
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 propertyRedirectUrlAfterCreate
The URL to which the engine should redirect after creation of the new object. Set to empty string to disable redirect.
Public propertyRedirectUrlAfterSave
URL to which the form redirects after successful save.
(Inherited from BasicForm.)
Public propertyRefreshHeader
Indicates whether header should be automatically refreshed when display name is changed.
Public propertyResolverName
Gets or sets macro resolver name.
(Inherited from BasicForm.)
Public propertySecurityCheck
Security check.
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 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 propertyUIContext
Returns control's UI context
(Inherited from CMSWebControl.)
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
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 eventOnCreate
Event for early initialization
Public eventOnDeleteFile
Occurs when the file is deleted.
(Inherited from BasicForm.)
Public eventOnGetAttachment
Occurs when an attachment is retrieved.
(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