New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
[RequiredScript(typeof(jQueryPlugins))]
[ClientScriptResource("Telerik.Web.UI.ControlItemContainer", "Telerik.Web.UI.Common.Navigation.NavigationScripts.js")]
[ClientScriptResource("Telerik.Web.UI.ControlItemContainer", "Telerik.Web.UI.Common.Navigation.OverlayScript.js")]
public abstract class ControlItemContainer : RadDataBoundControl, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, IPostBackDataHandler, ISkinnableControl, IControl, IFeatureGroup, INamingContainer, IXmlSerializable, IControlItemContainer

Inheritance: objectControlWebControlBaseDataBoundControlDataBoundControlRadDataBoundControlControlItemContainer...

Derived Classes: HierarchicalControlItemContainerRadComboBoxRadDropDownListRadListBoxRadSliderRadToolBar...

Implements: IAttributeAccessorIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlItemContainerIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorIFeatureGroupINamingContainerIParserAccessorIPostBackDataHandlerIScriptControlISkinnableControlIUrlResolutionServiceIXmlSerializable...

Inherited Members DataBoundControl.OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)DataBoundControl.CreateDataSourceSelectArguments()DataBoundControl.GetData()DataBoundControl.GetDataSource()DataBoundControl.MarkAsDataBound()DataBoundControl.OnDataPropertyChanged()DataBoundControl.OnDataSourceViewChanged(object, EventArgs)DataBoundControl.OnLoad(EventArgs)DataBoundControl.OnPagePreLoad(object, EventArgs)DataBoundControl.PerformSelect()DataBoundControl.ValidateDataSource(object)DataBoundControl.DataMemberDataBoundControl.IsUsingModelBindersDataBoundControl.ItemTypeDataBoundControl.SelectMethodDataBoundControl.DataSourceIDDataBoundControl.DataSourceObjectDataBoundControl.SelectArgumentsDataBoundControl.CreatingModelDataSourceDataBoundControl.CallingDataMethodsBaseDataBoundControl.ConfirmInitState()BaseDataBoundControl.DataBind()BaseDataBoundControl.EnsureDataBound()BaseDataBoundControl.OnDataBound(EventArgs)BaseDataBoundControl.OnInit(EventArgs)BaseDataBoundControl.OnPreRender(EventArgs)BaseDataBoundControl.DataSourceBaseDataBoundControl.InitializedBaseDataBoundControl.IsBoundUsingDataSourceIDBaseDataBoundControl.IsDataBindingAutomaticBaseDataBoundControl.SupportsDisabledAttributeBaseDataBoundControl.RequiresDataBindingBaseDataBoundControl.DataBoundWebControl.AddAttributesToRender(HtmlTextWriter)WebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.MergeStyle(Style)WebControl.Render(HtmlTextWriter)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.RenderContents(HtmlTextWriter)WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SkinIDWebControl.TabIndexWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

C#
protected ControlItemContainer()

Properties

C#
public virtual bool AppendDataBoundItems { get; set; }

Gets or sets a value indicating whether validation is performed when an item within the control is selected.

C#
public virtual bool CausesValidation { get; set; }
Property Value:

true if validation is performed when an item is selected; otherwise, false. The default value is true.

By default, page validation is performed when an item is selected. Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. You can specify or determine whether validation is performed on both the client and the server when an item is clicked by using the CausesValidation property. To prevent validation from being performed, set the CausesValidation property to false.

C#
protected ControlItemCollection Children { get; }
C#
public virtual string DataTextField { get; set; }
C#
public virtual string DataTextFormatString { get; set; }
C#
public virtual string DataValueField { get; set; }

Used to customize the keyboard navigation functionality.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
public virtual KeyboardNavigationSettings KeyboardNavigationSettings { get; }

Gets or sets the URL of the page to post to from the current page when a tab from the tabstrip is clicked.

C#
[Themeable(false)]
public virtual string PostBackUrl { get; set; }
Property Value:

The URL of the Web page to post to from the current page when a tab from the tabstrip control is clicked. The default value is an empty string (""), which causes the page to post back to itself.

C#
protected override HtmlTextWriterTag TagKey { get; }

Overrides: WebControl.TagKey

C#
protected ITemplate Template { get; set; }

Gets or sets the name of the validation group to which this validation control belongs.

C#
[Bindable(true)]
public virtual string ValidationGroup { get; set; }
Property Value:

The name of the validation group to which this validation control belongs. The default is an empty string (""), which indicates that this property is not set.

This property works only when CausesValidation is set to true.

Methods

C#
protected abstract ControlItemCollection CreateChildItemCollection()
Returns:

ControlItemCollection

C#
protected abstract ControlItem CreateItem()
Returns:

ControlItem

C#
protected virtual ControlItem CreateItem(ClientStateLogEntry logEntry)
Parameters:logEntryClientStateLogEntryReturns:

ControlItem

C#
protected override void DescribeComponent(IScriptDescriptor descriptor)
Parameters:descriptorIScriptDescriptor

Overrides: RadDataBoundControl.DescribeComponent(IScriptDescriptor)

C#
protected TControlItem FindChild<TControlItem>(Predicate<TControlItem> predicate) where TControlItem : ControlItem
Parameters:predicatePredicate<TControlItem>Returns:

TControlItem

C#
protected TControlItem FindChildByAttribute<TControlItem>(string attributeName, string attributeValue) where TControlItem : ControlItem
Parameters:attributeNamestringattributeValuestringReturns:

TControlItem

C#
protected TControlItem FindChildByText<TControlItem>(string text, bool ignoreCase) where TControlItem : ControlItem
Parameters:textstringignoreCaseboolReturns:

TControlItem

C#
protected TControlItem FindChildByText<TControlItem>(string text) where TControlItem : ControlItem
Parameters:textstringReturns:

TControlItem

C#
public virtual TControlItem FindChildByValue<TControlItem>(string value, bool ignoreCase) where TControlItem : ControlItem
Parameters:valuestringignoreCaseboolReturns:

TControlItem

C#
public virtual TControlItem FindChildByValue<TControlItem>(string value) where TControlItem : ControlItem
Parameters:valuestringReturns:

TControlItem

C#
protected virtual ControlItem FindItemByHierarchicalIndex(string hierarchicalIndex)
Parameters:hierarchicalIndexstringReturns:

ControlItem

C#
protected IList<TControlItem> GetAllChildren<TControlItem>() where TControlItem : ControlItem
Returns:

IList<TControlItem>

C#
protected virtual Type GetItemTypeFromXmlTagName(string xmlTagName)
Parameters:xmlTagNamestringReturns:

Type

C#
protected virtual string GetPostbackEventReference()
Returns:

string

Gets an XML string representing the state of the control. All child items and their properties are serialized in this string.

C#
public string GetXml()
Returns:

string

A String representing the state of the control - child items, properties etc.

Use the GetXml method to get the XML state of the control. You can cache it and then restore it using the LoadXml(string) method.

C#
protected virtual void GetXml(XmlSerializer serializer, TextWriter output)
Parameters:serializerXmlSerializeroutputTextWriter
C#
protected virtual void InitializeItem(ControlItem item)
Parameters:itemControlItem
C#
protected override void LoadViewState(object savedState)
Parameters:savedStateobject

Overrides: DataBoundControl.LoadViewState(object)

C#
protected virtual void LoadXml(ControlItemContainer deserialized)
Parameters:deserializedControlItemContainer

Loads the control from an XML string.

C#
public void LoadXml(string xml)
Parameters:xmlstring

The string representing the XML from which the control will be populated.

Use the LoadXml method to populate the control from an XML string. You can use it along the GetXml() method to implement caching.

C#
protected override void PerformDataBinding(IEnumerable data)
Parameters:dataIEnumerable

Overrides: DataBoundControl.PerformDataBinding(IEnumerable)

C#
protected void PrepareForDataBinding()
C#
protected abstract void RaiseItemCreated(ControlItem item)
Parameters:itemControlItem
C#
protected abstract void RaiseItemDataBound(ControlItem item)
Parameters:itemControlItem
C#
protected virtual void RaiseTemplateNeeded(ControlItem item)
Parameters:itemControlItem
C#
protected virtual void ReadXml(XmlReader reader)
Parameters:readerXmlReader
C#
protected virtual void ReadXmlForChildren(XmlReader reader)
Parameters:readerXmlReader
C#
protected override object SaveViewState()
Returns:

object

Overrides: DataBoundControl.SaveViewState()

C#
protected override void TrackViewState()

Overrides: DataBoundControl.TrackViewState()

C#
protected virtual void WriteXml(XmlWriter writer)
Parameters:writerXmlWriter
C#
protected virtual void WriteXmlForChildren(XmlWriter writer)
Parameters:writerXmlWriter