SiteSeparatedObjectSelector Class

Abstract class providing common functionality for selectors offering site-separated objects.

Inheritance Hierarchy

System.Object
  System.Web.UI.Control
    System.Web.UI.TemplateControl
      System.Web.UI.UserControl
        CMS.ExtendedControls.AbstractUserControl
          CMS.ExtendedControls.InlineUserControl
            CMS.FormControls.FormEngineUserControl
              CMS.Ecommerce.BaseObjectSelector
                CMS.Ecommerce.SiteSeparatedObjectSelector

Namespace: CMS.Ecommerce
Assembly: CMS.Ecommerce (in CMS.Ecommerce.dll) Version: 8.2.23

Syntax

public abstract class SiteSeparatedObjectSelector : BaseObjectSelector

The SiteSeparatedObjectSelector type exposes the following members.

Constructors

	Name	Description
Protected method	SiteSeparatedObjectSelector

Methods

	Name	Description
Public method	AddConfirmation	Adds confirmation text to existing message on the page. (Inherited from AbstractUserControl.)
Public method	AddError	Adds error text to existing message on the page. (Inherited from AbstractUserControl.)
Public method	AddHeaderAction	Adds specified action to the page header actions. (Inherited from AbstractUserControl.)
Public method	AddInformation	Adds information text to existing message on the page. (Inherited from AbstractUserControl.)
Public method	AddMessage	Adds message text to existing message on the page. (Inherited from AbstractUserControl.)
Public method	AddWarning	Adds warning text to existing message on the page. (Inherited from AbstractUserControl.)
Protected method	AppendAdditionalItemsWhere	Appends where adding additional items. (Inherited from BaseObjectSelector.)
Protected method	AppendEnabledWhere	Appends where restricting to enabled items. (Inherited from BaseObjectSelector.)
Protected method	AppendExclusiveWhere	Appends restrictive part of where condition to given where condition. (Overrides BaseObjectSelector.AppendExclusiveWhere(String).)
Protected method	AppendInclusiveWhere	Appends widening part of where condition to given where condition. (Inherited from BaseObjectSelector.)
Protected method	AppendSelectedItemWhere	Appends where condition including selected item. (Inherited from BaseObjectSelector.)
Protected method	AppendSiteWhere	Appends site where to given where condition.
Protected method	ConnectToForm	Connects the given form control to a form if necessary (Inherited from FormEngineUserControl.)
Protected method	ContainsColumn	Indicates if form control's DataRow contains requested column. (Inherited from FormEngineUserControl.)
Protected method	ConvertInputValue	Ensures that the given value is represented as null is empty, or converted to proper type. (Inherited from FormEngineUserControl.)
Public method	EnsureControls	Interface for control that is able to explicitly ensure its child controls (Inherited from AbstractUserControl.)
Public method	Eval(String)	Evaluates the given value (Inherited from AbstractUserControl.)
Public method	Eval(String, Boolean)	Evaluates the item data (safe version), with html encoding. (Inherited from AbstractUserControl.)
Public method	EvalBool	Evaluates the item data and converts it to the bool. (Inherited from AbstractUserControl.)
Public method	EvalDateTime	Evaluates the item data and converts it to the date time. (Inherited from AbstractUserControl.)
Public method	EvalDouble	Evaluates the item data and converts it to the integer. (Inherited from AbstractUserControl.)
Public method	EvalGuid	Evaluates the item data and converts it to the guid. (Inherited from AbstractUserControl.)
Public method	EvalHTML	Evaluates the item data and doesn't encode it. Method should be used for columns with html content. (Inherited from AbstractUserControl.)
Public method	EvalHtmlAttribute	Evaluates the item data, encodes it to be used in HTML attribute. (Inherited from AbstractUserControl.)
Public method	EvalInteger	Evaluates the item data and converts it to the integer. (Inherited from AbstractUserControl.)
Public method	EvalJSString	Evaluates the item data, encodes it to be used in javascript code and encapsulates it with "'". (Inherited from AbstractUserControl.)
Public method	EvalText(String)	Evaluates the item data and encodes it. Method should be used for columns with string nonhtml content. (Inherited from AbstractUserControl.)
Public method	EvalText(String, Boolean)	Evaluates the item data and encodes it. Method should be used for columns with string nonhtml content. (Inherited from AbstractUserControl.)
Protected method	Form_ControlWithDependenciesChanged	Another form control, which has some dependencies, has changed. (Inherited from FormEngineUserControl.)
Protected method	GenerateBaseWhere	Returns base where condition. This condition is applied always. Returns empty where condition by default - override this method to generate custom condition. (Inherited from BaseObjectSelector.)
Protected method	GenerateWhereCondition	Generates where condition for uniselector. (Inherited from BaseObjectSelector.)
Protected method	GetCodeName	Converts ID of the object to its codename. (Inherited from BaseObjectSelector.)
Protected method	GetColumnValue	Gets the given column value from the form data (Inherited from FormEngineUserControl.)
Public method	GetControlInfoMarker	Gets the control info marker code (Inherited from FormEngineUserControl.)
Protected method	GetDialogConfiguration	Returns dialog configuration from the specified form control settings. (Inherited from FormEngineUserControl.)
Public method	GetFlagIconUrl	Returns resolved path to the flag image for the specified culture. (Inherited from AbstractUserControl.)
Protected method	GetID	Converts object name to ID on the specific site (Inherited from BaseObjectSelector.)
Public method	GetImagePath	Gets UI image relative path. (Inherited from AbstractUserControl.)
Public method	GetImageUrl	Gets UI image relative path. (Inherited from AbstractUserControl.)
Protected method	GetInputClientID	Gets client ID of first inner control. (Inherited from FormEngineUserControl.)
Protected method	GetInputControlID	Gets control ID of first inner control. (Inherited from FormEngineUserControl.)
Protected method	GetNewItemUrl	Returns url of quick add dialog. (Inherited from BaseObjectSelector.)
Public method	GetOtherValue	Returns a value of other field with specified returned by the control. (Inherited from FormEngineUserControl.)
Public method	GetOtherValues	Returns an array of values of any other fields returned by the control. (Inherited from FormEngineUserControl.)
Public method	GetResolvedValue<ReturnType>	Gets resolved property value (Inherited from FormEngineUserControl.)
Public method	GetSpellCheckFields	Returns the list of the field IDs (Client IDs of the inner controls) that should be spell checked. (Inherited from FormEngineUserControl.)
Public method	GetString	Returns localized string. (Inherited from AbstractUserControl.)
Protected method	GetStringValue	Gets the string value from the given value (Inherited from FormEngineUserControl.)
Public method	GetValue(String)	Returns the value of the given property. (Inherited from FormEngineUserControl.)
Public method	GetValue<ReturnType>(String, ReturnType)	Returns the value of the given property. (Inherited from InlineUserControl.)
Public method	GetWhereCondition	Gets a where condition. Returns where condition formatted by WhereConditionFormat from IFilterFormControl interface if form control implements it. Otherwise returns where condition in [FieldName] = 'Value' format. (Inherited from FormEngineUserControl.)
Public method	HasValue	Returns true if the value of the given property is set. (Inherited from InlineUserControl.)
Protected method	InitSelector	Initializes the selector. (Overrides BaseObjectSelector.InitSelector().)
Public method	IsValid	Returns true if entered data is valid. If data is invalid, it returns false and displays an error message. (Inherited from FormEngineUserControl.)
Public method	LoadControlFromFFI	Loads control with values in FormFieldInfo. (Inherited from FormEngineUserControl.)
Public method	LoadControlValue	Loads control value. (Inherited from FormEngineUserControl.)
Public method	LoadDefaultProperties	Loads the default properties from the given form definition (Inherited from FormEngineUserControl.)
Public method	LoadOtherValues	Loads the other fields values to the state of the form control (Inherited from FormEngineUserControl.)
Public method	LoadUserControl	Loads the user control based on the given path (Inherited from AbstractUserControl.)
Public method	LogAndShowError	Logs the exception and (Inherited from AbstractUserControl.)
Protected method	OnAfterRetrieveData	Called after selector data are retrieved. (Inherited from BaseObjectSelector.)
Public method	OnContentLoaded	Method that is called when the control content is loaded. (Inherited from InlineUserControl.)
Protected method	OnInit	Initializes of the selector. (Inherited from BaseObjectSelector.)
Protected method	OnListItemCreated	Called when item in selector is created. (Inherited from BaseObjectSelector.)
Protected method	OnLoad	Load data for selector. (Inherited from BaseObjectSelector.)
Protected method	OnPreRender	PreRender event handler. (Inherited from AbstractUserControl.)
Protected method	RaiseOnChanged	Raises the Changed event. (Inherited from FormEngineUserControl.)
Public method	Reload	Reloads selector. (Inherited from BaseObjectSelector.)
Protected method	ReloadControl	Virtual method that can be used in specific form control to reload its content. It is called after the change of another form control which has some dependencies. (Inherited from FormEngineUserControl.)
Protected method	Render	Renders user control. (Inherited from FormEngineUserControl.)
Public method	ResolveUrl	Resolves the given URL (Inherited from AbstractUserControl.)
Public method	SetValue(String, Object)	Sets the property value of the control, setting the value affects only local property value. (Inherited from FormEngineUserControl.)
Public method	SetValue(String, Object, Boolean)	Sets the property value of the control, setting the value affects only local property value. (Inherited from FormEngineUserControl.)
Public method	ShowConfirmation	Shows the general confirmation message. (Inherited from AbstractUserControl.)
Public method	ShowError	Shows the specified error message, optionally with a tooltip text. (Inherited from AbstractUserControl.)
Public method	ShowChangesSaved	Shows the general changes saved message. (Inherited from AbstractUserControl.)
Public method	ShowInformation	Shows the given information on the page, optionally with a tooltip text. (Inherited from AbstractUserControl.)
Public method	ShowMessage(MessageTypeEnum, String, String, String, Boolean)	Shows the specified message, optionally with a tooltip text. (Inherited from AbstractUserControl.)
Protected method	ShowMessage(MessageTypeEnum, String, String, String, Boolean, Boolean)	Shows the specified message, optionally with a tooltip text. (Inherited from AbstractUserControl.)
Public method	ShowWarning	Shows the specified warning message, optionally with a tooltip text. (Inherited from AbstractUserControl.)
Protected method	TrackViewState	Tracks the view state. (Inherited from InlineUserControl.)
Protected method	UnderlyingFormControl_Changed	Changed handler. (Inherited from FormEngineUserControl.)
Public method	ValidateMacroValue	Returns true if the given macro value is valid value for this control (Inherited from FormEngineUserControl.)

Extension Methods

	Name	Description
Public Extension Method	AsValue	Converts object to a query value which can be used as a query parameter (Defined by QueryExtensions.)
Public Extension Method	CallHandled	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 Method	GetAPIString	Gets the string by the specified resource key (Defined by CoreExtensions.)
Public Extension Method	GetString	Gets the string by the specified resource key (Defined by CoreExtensions.)
Public Extension Method	ToBoolean	Returns the boolean representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToDateTime	Returns the DateTime representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToDouble	Returns the double representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToGuid	Returns the Guid representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToInteger	Returns the integer representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToString	Returns the string representation of an object or default value if not. (Defined by CoreExtensions.)

Fields

	Name	Description
Protected field	mViewStateTracked	If true, the ViewState has been already tracked. (Inherited from InlineUserControl.)
Protected field	properties	Control properties. (Inherited from InlineUserControl.)

Properties

	Name	Description
Public property	AddAllItemsRecord	Gets or sets the value which determines, whether to add 'all' item record to the selector. (Inherited from BaseObjectSelector.)
Public property	AdditionalItems	ID of items which have to be displayed. Use ',' or ';' as separator if more IDs required. (Inherited from BaseObjectSelector.)
Public property	AddNoneRecord	Determines whether to add 'none' item record to the selector. (Inherited from BaseObjectSelector.)
Protected property	AllowCombineSiteAndGlobal	Indicates if objects can be combined site and global within one site. False means that site can use only global or only site records. (Inherited from BaseObjectSelector.)
Public property	AllowCreate	Indicates whether new button will be visible and creating of new object allowed. (Inherited from BaseObjectSelector.)
Public property	AutoPostBack	Determines whether the AutoPostBack property of dropdown list should be enabled. (Inherited from BaseObjectSelector.)
Protected property	CodeNameColumn	Name of the column containing code name. (Inherited from BaseObjectSelector.)
Public property	ComponentName	Component name (Inherited from AbstractUserControl.)
Public property	ContextResolver	Gets or sets macro resolver for given control. (Inherited from FormEngineUserControl.)
Public property	ControlStyle	CSS style of the control. (Inherited from FormEngineUserControl.)
Public property	CssClass	CSS class of the control. (Inherited from FormEngineUserControl.)
Public property	CurrentDocument	Current document (Inherited from AbstractUserControl.)
Public property	CurrentPageInfo	Current page info (Inherited from AbstractUserControl.)
Public property	CurrentSite	Current site (Inherited from AbstractUserControl.)
Public property	CurrentUser	Current user (Inherited from AbstractUserControl.)
Public property	Data	Node data. This property is used only for passing values to the control. (Inherited from FormEngineUserControl.)
Public property	DefaultProperties	Control properties (Inherited from FormEngineUserControl.)
Public property	DependsOnAnotherField	Indicates if field depends on another field. (Inherited from FormEngineUserControl.)
Public property	DisplayGlobalItems	Indicates whether site records are to be offered. Default value is based on IncludeGlobalItems property.
Public property	DisplayOnlyEnabled	Allows to display only enabled items. Default value is true. (Inherited from BaseObjectSelector.)
Public property	DisplaySiteItems	Indicates whether site records are to be offered. Default value is based on IncludeGlobalItems property.
Public property	DocumentManager	Document manager control (Inherited from AbstractUserControl.)
Public property	EditedObject	Control's edited object (Inherited from AbstractUserControl.)
Protected property	EmptyObject	Empty info object of the same type as selected objects. (Inherited from BaseObjectSelector.)
Public property	Enabled	Gets or sets the enabled state of the selector. (Inherited from BaseObjectSelector.)
Protected property	EnabledColumn	Name of the column containing enabled flag. (Inherited from BaseObjectSelector.)
Public property	EnsureSelectedItem	Indicates whether selected item must be on the list despite of other settings. Default value is false. (Inherited from BaseObjectSelector.)
Public property	ErrorMessage	Control custom error message. (Inherited from FormEngineUserControl.)
Public property	Field	Field name to which the field belongs. This property is only supported in templated form. (Inherited from FormEngineUserControl.)
Public property	FieldInfo	Field info object. (Inherited from FormEngineUserControl.)
Public property	Form	Parent form. (Inherited from FormEngineUserControl.)
Public property	FormControlParameter	Helper property to use custom parameter in form control. (Inherited from FormEngineUserControl.)
Public property	HasData	Indicates if selector has data. (Inherited from BaseObjectSelector.)
Public property	HasDependingFields	Indicates if another fields depend on this field. (Inherited from FormEngineUserControl.)
Public property	HasValue	Returns true if the control has value, if false, the value from the control should not be used within the form to update the data (Inherited from FormEngineUserControl.)
Public property	HeaderActions	Header actions control (Inherited from AbstractUserControl.)
Public property	CheckFieldEmptiness	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 file uploaders. Field emptiness validation then must be placed in custom form control in IsValid() method. (Inherited from FormEngineUserControl.)
Public property	CheckMinMaxLength	Indicates that field should be checked on min/max input length in validation step by BasicForm. Default FALSE. It is preferable to set to TRUE for simple text input controls such as TextBox. (Inherited from FormEngineUserControl.)
Public property	CheckRegularExpression	Indicates that field should be checked on regular expressions in validation step by BasicForm. Default FALSE. It is preferable to set to TRUE for controls where user should be able to enter text such as TextBox. (Inherited from FormEngineUserControl.)
Public property	CheckUnique	If true, the field is checked for uniqueness. This property is only supported in templated form. (Inherited from FormEngineUserControl.)
Protected property	IDColumn	Name of the column containing ID. (Inherited from BaseObjectSelector.)
Public property	IncludeGlobalItems	Indicates whether global objects are to be offered.
Public property	InputClientID	Client ID of primary input control. If not explicitly set, first client ID of inner control of the form control is returned. (Inherited from FormEngineUserControl.)
Public property	InputControlID	Control ID of primary input control. If not explicitly set, first control ID of inner control of the form control is returned. (Inherited from FormEngineUserControl.)
Public property	IsLiveSite	Indicates if control is used on live site. (Inherited from AbstractUserControl.)
Public property	Item	Gets or sets the value of the column. (Inherited from InlineUserControl.)
Public property	MessagesPlaceHolder	Placeholder for messages (Inherited from AbstractUserControl.)
Protected property	ObjectType	Object type name of selected objects. (Inherited from BaseObjectSelector.)
Public property	Parameter	Control parameter. (Inherited from InlineUserControl.)
Public property	RememberOriginalValue	If true, the control remembers the original value for evaluation (Inherited from FormEngineUserControl.)
Public property	ResolverName	Gets or sets macro resolver name. (Inherited from FormEngineUserControl.)
Public property	SelectedID	Gets or sets the ID of selected item. (Inherited from BaseObjectSelector.)
Public property	SelectedName	Gets or sets the codename of selected item. (Inherited from BaseObjectSelector.)
Public property	ShortID	Short ID of the control. (Inherited from AbstractUserControl.)
Public property	SiteID	Allows to display records only for specified site ID. Use 0 for global objects. Default value is current site ID. (Overrides BaseObjectSelector.SiteID.)
Protected property	SiteIDColumn	Name of the column containing ID of the site. (Inherited from BaseObjectSelector.)
Public property	StopProcessing	If true, control does not process the data. (Inherited from BaseObjectSelector.)
Public property	Text	Gets or sets Value converted to string. (Inherited from FormEngineUserControl.)
Public property	Trim	If true, the returned value is trimmed. This property is only supported if used inside the form control. Default false. (Inherited from FormEngineUserControl.)
Public property	UIContext	Control's UI Context (Inherited from AbstractUserControl.)
Protected property	UnderlyingFormControl	Underlying form control, if provided, the form control automatically redirects all properties to that control (Inherited from FormEngineUserControl.)
Public property	UniSelector	Getter to be overridden. Gets uniselector object used for selecting objects. (Inherited from BaseObjectSelector.)
Public property	UseNameForSelection	Indicates whether code name is to be used for selecting items. (Inherited from BaseObjectSelector.)
Public property	UsesLocalMessagesPlaceHolder	Indicates if control uses local messages placeholder (Inherited from AbstractUserControl.)
Public property	ValidationError	Validation error string shown when the control is not valid. (Inherited from FormEngineUserControl.)
Public property	Value	Gets or sets the selected value. (Inherited from BaseObjectSelector.)
Public property	ValueDisplayName	Gets the display name of the value item. Returns null if display name is not available. (Inherited from BaseObjectSelector.)
Public property	ValueElementID	Returns ClientID of the dropdown list. (Inherited from BaseObjectSelector.)
Public property	ValueForValidation	Returns value prepared for validation. (Inherited from FormEngineUserControl.)
Protected property	ViewState	ViewState - overridden for the Master page ViewState fix. (Inherited from InlineUserControl.)
Public property	WhereConditionFormat	Format of where condition. (Inherited from FormEngineUserControl.)

Events

	Name	Description
Public event	Changed	Fired on the change to the form control. (Inherited from FormEngineUserControl.)