ObjectSelectorComponentBase<TProperties, TSelectorItem> Class

The base component class used in selectors that leverage the object selector user interface.

Inheritance Hierarchy

System.Object
  Kentico.Forms.Web.Mvc.FormComponent
    Kentico.Forms.Web.Mvc.FormComponent<TProperties, IEnumerable<TSelectorItem>>
      Kentico.Components.Web.Mvc.Selectors.Internal.ObjectSelectorComponentBase<TProperties, TSelectorItem>
        Kentico.Components.Web.Mvc.FormComponents.GeneralSelector
        Kentico.Components.Web.Mvc.FormComponents.ObjectSelector

Namespace: Kentico.Components.Web.Mvc.Selectors.Internal
Assembly: Kentico.Content.Web.Mvc (in Kentico.Content.Web.Mvc.dll) Version: 13.0.131

Syntax

public abstract class ObjectSelectorComponentBase<TProperties, TSelectorItem> : FormComponent<TProperties, IEnumerable<TSelectorItem>>, 
	IObjectSelectorComponentBase<TProperties, TSelectorItem>
where TProperties : new(), ObjectSelectorPropertiesBase<TSelectorItem>, IObjectSelectorPropertiesBase
where TSelectorItem : new(), IObjectSelectorItem

Type Parameters

TProperties

TSelectorItem

The ObjectSelectorComponentBase<TProperties, TSelectorItem> type exposes the following members.

Constructors

	Name	Description
Protected method	ObjectSelectorComponentBase<TProperties, TSelectorItem>

Properties

	Name	Description
Public property	BaseProperties	Gets the form component's properties as its base type. (Inherited from FormComponent<TProperties, TValue>.)
Public property	CustomAutopostHandling	If true, prevents built-in visibility condition handling for this component. (Inherited from FormComponent.)
Public property	Definition	Gets or sets the definition under which the form component is registered in the system. (Inherited from FormComponent.)
Public property	HasDependingFields	Gets or sets a value indicating whether there are another form components whose visibility condition depends on this component's value. (Inherited from FormComponent.)
Public property	InstanceIdentifier	Gets the selector instance identifier.
Public property	LabelForPropertyName	Gets the name of the property representing the editing field in the resulting HTML markup. The name is used to infer a proper label for attribute value in the rendered HTML markup. Defaults to first found property annotated with BindablePropertyAttribute. (Inherited from FormComponent.)
Public property	Name	Gets or sets the name of the corresponding form field. The name is used as a prefix when naming the HTML input. (Inherited from FormComponent.)
Public property	Properties	Gets the form component's properties. (Inherited from FormComponent<TProperties, TValue>.)
Public property	PropertiesType	Gets the properties type of the form component. (Inherited from FormComponent.)
Protected property	SelectedItemValues	Gets the currently selected typed values.
Public property	SelectedValue	Represents the serialized selected value.
Public property	SelectorPropertyDescriptor	Gets the component property descriptor which identifies the component property that uses this selector.
Protected property	SerializerSettings	The selector serialization settings used across all selector serializations and deserializations.
Public property	ShowPartialValidationMessages	Also shows validation errors of partial values of the component. If false, each individual component should contain validation message in its partial view. (Inherited from FormComponent.)

Methods

	Name	Description
Public method	BindContext	Binds contextual information to the form component. The actual type of context depends on where the component is being used. The component can throw an exception if being used in a context for which it is not designed. The base implementation provided by this class must be called prior to throwing an exception, however. (Overrides FormComponent.BindContext(FormComponentContext).)
Public method	GetDisplayName	Returns non-localized string representing component name. Component Name is returned in case of empty Label. (Inherited from FormComponent.)
Public method	GetItemsEndpointUrl	Gets the endpoint URL that provides data for the selector component.
Public method	GetModelPropertyCustomAttributes<T>	Gets a collection of custom attributes applied to the model's property this form component represents. (Inherited from FormComponent.)
Public method	GetObjectValue	Gets the value of the form component. The GetValue() method can be used directly to obtain the typed value. (Inherited from FormComponent<TProperties, TValue>.)
Public method	GetSelectedListItems	Returns selected objects as list items.
Public method	GetValue	Gets the value of the form component. Implement in a subclass to return value of a desired property. Method can also be used to return a value composed of multiple properties if required. (Overrides FormComponent<TProperties, TValue>.GetValue().)
Public method	LoadProperties	Loads properties of the form component. The actual properties type must match the PropertiesType. (Inherited from FormComponent<TProperties, TValue>.)
Public method	ModifyMetadata	Modifies modelMetadata according to the current object. (Inherited from FormComponent.)
Public method	SetObjectValue	Sets the value of the form component. The value must be of proper type or an exception is thrown. The SetValue(TValue) method can be used directly to set the typed default value. (Inherited from FormComponent<TProperties, TValue>.)
Public method	SetValue	Sets the value of the form component. Implement in a subclass to set value of a desired property. Method can also be used to decompose passed value into several properties rendered in the resulting form component markup. (Overrides FormComponent<TProperties, TValue>.SetValue(TValue).)
Public method	Validate	Determines whether the specified object is valid. Only invoked if validation by validation attributes passes for all fields. (Overrides FormComponent.Validate(ValidationContext).)

Extension Methods

	Name	Description
Public Extension Method	GetBizFormComponentContext	Gets BizFormComponentContext of a form component, if such a context was bound to the component. (Defined by FormComponentExtensions.)