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#
[EmbeddedSkin("DropDownList", typeof(RadDropDownList))]
[EmbeddedSkin("DropDownList", "Default", typeof(RadDropDownList))]
[RequiredCss("Telerik.Web.UI.Skins.Common.fonticons.css", RenderMode.Lightweight, typeof(RadDropDownList))]
[RequiredCss("Telerik.Web.UI.Skins.Common.MaterialRipple.css", RenderMode.Lightweight, typeof(RadButton))]
[RequiredScript(typeof(jQueryPlugins), 1)]
[RequiredScript(typeof(DropDown), 2)]
[RequiredScript(typeof(TouchScrollExtender), 3)]
[RequiredScript(typeof(MaterialRipple))]
[ClientScriptResource("Telerik.Web.UI.RadDropDownList", "Telerik.Web.UI.DropDownList.RadDropDownListScripts.js")]
[TelerikToolboxCategory("Data Editing")]
public class RadDropDownList : ControlItemContainer, IScriptControl, IControlResolver, IPostBackDataHandler, ISkinnableControl, IControl, IFeatureGroup, INamingContainer, IXmlSerializable, IControlItemContainer, ICallbackEventHandler, IPostBackEventHandler, IFlatBoundContainer

Inheritance: objectRadDataBoundControlControlItemContainerRadDropDownList

Implements: ICallbackEventHandlerIControlIControlItemContainerIControlResolverIFeatureGroupIFlatBoundContainerINamingContainerIPostBackDataHandlerIPostBackEventHandlerIScriptControlISkinnableControlIXmlSerializable...

Inherited Members ControlItemContainer.PrepareForDataBinding()ControlItemContainer.GetXml()ControlItemContainer.LoadXml(string)ControlItemContainer.CreateItem(ClientStateLogEntry)ControlItemContainer.FindChild<TControlItem>(Predicate<TControlItem>)ControlItemContainer.GetAllChildren<TControlItem>()ControlItemContainer.FindChildByValue<TControlItem>(string)ControlItemContainer.FindChildByValue<TControlItem>(string, bool)ControlItemContainer.FindChildByText<TControlItem>(string)ControlItemContainer.FindChildByText<TControlItem>(string, bool)ControlItemContainer.FindChildByAttribute<TControlItem>(string, string)ControlItemContainer.InitializeItem(ControlItem)ControlItemContainer.ReadXml(XmlReader)ControlItemContainer.GetItemTypeFromXmlTagName(string)ControlItemContainer.ReadXmlForChildren(XmlReader)ControlItemContainer.WriteXml(XmlWriter)ControlItemContainer.WriteXmlForChildren(XmlWriter)ControlItemContainer.GetXml(XmlSerializer, TextWriter)ControlItemContainer.LoadXml(ControlItemContainer)ControlItemContainer.LoadViewState(object)ControlItemContainer.SaveViewState()ControlItemContainer.TrackViewState()ControlItemContainer.FindItemByHierarchicalIndex(string)ControlItemContainer.GetPostbackEventReference()ControlItemContainer.AppendDataBoundItemsControlItemContainer.DataTextFieldControlItemContainer.DataValueFieldControlItemContainer.DataTextFormatStringControlItemContainer.ValidationGroupControlItemContainer.PostBackUrlControlItemContainer.CausesValidationControlItemContainer.KeyboardNavigationSettingsControlItemContainer.TemplateControlItemContainer.ChildrenRadDataBoundControl.ResolveRenderMode()RadDataBoundControl.CanRenderInMode(RenderModeBrowserAdaptor, RenderMode)RadDataBoundControl.PreferredRenderMode(RenderModeBrowserAdaptor)RadDataBoundControl.GetSkinSuffix()RadDataBoundControl.OnPreRender(EventArgs)RadDataBoundControl.ControlPreRender()RadDataBoundControl.RenderSmartPasteDescriptionAttribute()RadDataBoundControl.ConfigureCombinedScriptFile()RadDataBoundControl.ConfigureCombinedBaseSkinFile()RadDataBoundControl.RegisterScriptControl()RadDataBoundControl.RegisterCssReferences()RadDataBoundControl.RegisterScriptDescriptors()RadDataBoundControl.LoadClientState(Dictionary<string, object>)RadDataBoundControl.SaveClientState()RadDataBoundControl.RenderClientStateField(HtmlTextWriter)RadDataBoundControl.RenderBeginTag(HtmlTextWriter)RadDataBoundControl.RenderEndTag(HtmlTextWriter)RadDataBoundControl.Render(HtmlTextWriter)RadDataBoundControl.RenderScriptsNoScriptManager(HtmlTextWriter)RadDataBoundControl.RenderDescriptorsNoScriptManager(HtmlTextWriter)RadDataBoundControl.ApplyConditionalRendering(HtmlTextWriter)RadDataBoundControl.RenderClassic(HtmlTextWriter)RadDataBoundControl.RenderLite(HtmlTextWriter)RadDataBoundControl.RenderNative(HtmlTextWriter)RadDataBoundControl.InitializeRenderMode()RadDataBoundControl.OnInit(EventArgs)RadDataBoundControl.DescribeRenderingMode(IScriptDescriptor)RadDataBoundControl.DescribeProperty<T>(IScriptDescriptor, string, T, T)RadDataBoundControl.DescribeEvent(IScriptDescriptor, string, string)RadDataBoundControl.GetEmbeddedSkinNames()RadDataBoundControl.GetScriptDescriptors()RadDataBoundControl.GetScriptReferences()RadDataBoundControl.GetViewScriptReference()RadDataBoundControl.RaisePostDataChangedEvent()RadDataBoundControl.GetViewStateValue<T>(string, T)RadDataBoundControl.FeatureGroupIDRadDataBoundControl.RegisterWithScriptManagerRadDataBoundControl.SkinRadDataBoundControl.EnableRippleEffectRadDataBoundControl.EnableEmbeddedScriptsRadDataBoundControl.EnableEmbeddedSkinsRadDataBoundControl.EnableEmbeddedBaseStylesheetRadDataBoundControl.ODataDataSourceIDRadDataBoundControl.ClientDataSourceIDRadDataBoundControl.DataModelIDRadDataBoundControl.RuntimeSkinRadDataBoundControl.EnableAjaxSkinRenderingRadDataBoundControl.ClientStateFieldIDRadDataBoundControl.RenderModeRadDataBoundControl.ResolvedRenderModeRadDataBoundControl.SupportsAdaptiveRenderingRadDataBoundControl.SupportsNativeRenderingRadDataBoundControl.SupportsLightweightRenderingRadDataBoundControl.DefaultCssClassRadDataBoundControl.IsRenderModeSetRadDataBoundControl.IsBoundUsingODataRadDataBoundControl.IsBoundUsingClientDataSourceRadDataBoundControl.RenderingCompatibilityRadDataBoundControl.ClientIDModeRadDataBoundControl.ScriptManagerRadDataBoundControl.RadScriptManagerRadDataBoundControl.RadStyleSheetManagerRadDataBoundControl.RendererRadDataBoundControl.AccessKeyRadDataBoundControl.BackColorRadDataBoundControl.BorderColorRadDataBoundControl.BorderStyleRadDataBoundControl.BorderWidthRadDataBoundControl.CssClassRadDataBoundControl.EnabledRadDataBoundControl.EnableThemingRadDataBoundControl.ForeColorRadDataBoundControl.FontRadDataBoundControl.SkinIDRadDataBoundControl.VisibleRadDataBoundControl.WidthRadDataBoundControl.TabIndexRadDataBoundControl.ToolTipRadDataBoundControl.DataMemberRadDataBoundControl.DataSourceRadDataBoundControl.DataSourceIDRadDataBoundControl.EnableViewState...

Constructors

C#
public RadDropDownList()

Properties

C#
public WaiAriaSettings AriaSettings { get; }
C#
[Bindable(false)]
[ClientControlProperty]
public bool AutoPostBack { get; set; }
C#
[Browsable(false)]
public IList<ClientOperation<DropDownListItem>> ClientChanges { get; }
C#
[Browsable(false)]
public string ClientItemTemplate { get; set; }
C#
public AnimationSettings CollapseAnimation { get; }
C#
protected override string CssClassFormatString { get; }

Overrides: RadDataBoundControl.CssClassFormatString

C#
[ClientControlProperty]
[Bindable(true)]
public virtual string DefaultMessage { get; set; }
C#
[Bindable(true)]
[ClientControlProperty]
[ClientPropertyName("_dropDownAutoWidth")]
public RadDropDownListDropDownAutoWidth DropDownAutoWidth { get; set; }
C#
[ClientControlProperty]
public Unit DropDownHeight { get; set; }
C#
[ClientControlProperty]
public Unit DropDownWidth { get; set; }
C#
[ClientControlProperty]
[ClientPropertyName("enableAriaSupport")]
public bool EnableAriaSupport { get; set; }
C#
[Bindable(false)]
[ClientControlProperty]
[ClientPropertyName("_enableDirectionDetection")]
public bool EnableDirectionDetection { get; set; }
C#
[Bindable(false)]
[ClientControlProperty]
[ClientPropertyName("_enableScreenBoundaryDetection")]
public bool EnableScreenBoundaryDetection { get; set; }
C#
[Bindable(false)]
[ClientControlProperty]
public bool EnableVirtualScrolling { get; set; }
C#
public AnimationSettings ExpandAnimation { get; }
C#
[ClientControlProperty]
[ClientPropertyName("expandDirection")]
public DropDownListExpandDirection ExpandDirection { get; set; }

Height

Unit

C#
public override Unit Height { get; }

Overrides: RadDataBoundControl.Height

C#
[Bindable(false)]
[ClientControlProperty]
public int ItemCountPerRequest { get; set; }
C#
public DropDownListItemCollection Items { get; }

ItemTemplate

ITemplate

C#
[Browsable(false)]
[Bindable(false)]
public virtual ITemplate ItemTemplate { get; set; }
C#
[TypeConverter("Telerik.Web.Design.AjaxLoadingPanelIDConverter, Telerik.Web.Design, Version=2026.3.812.462, Culture=neutral, PublicKeyToken=121fae78165ba3d4")]
[ClientPropertyName("_loadingPanelID")]
[ClientControlProperty]
public string LoadingPanelID { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("dropDownClosed")]
public string OnClientDropDownClosed { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("dropDownClosing")]
public string OnClientDropDownClosing { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("dropDownOpened")]
public string OnClientDropDownOpened { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("dropDownOpening")]
public string OnClientDropDownOpening { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("itemDataBound")]
public string OnClientItemDataBound { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("itemSelected")]
public string OnClientItemSelected { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("itemSelecting")]
public string OnClientItemSelecting { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("itemsRequested")]
public string OnClientItemsRequested { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("itemsRequestFailed")]
public string OnClientItemsRequestFailed { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("itemsRequesting")]
public string OnClientItemsRequesting { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("load")]
public string OnClientLoad { get; set; }
C#
[Bindable(false)]
[ClientControlEvent]
[ClientPropertyName("selectedIndexChanged")]
public string OnClientSelectedIndexChanged { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("templateDataBound")]
public string OnClientTemplateDataBound { get; set; }
C#
[Bindable(true)]
[Browsable(false)]
[ClientControlProperty]
[ClientPropertyName("_selectedIndex")]
public int SelectedIndex { get; set; }
C#
[Bindable(false)]
[Browsable(false)]
public virtual DropDownListItem SelectedItem { get; }
C#
[Browsable(false)]
[Bindable(true, BindingDirection.TwoWay)]
[ClientControlProperty]
[ClientPropertyName("_selectedText")]
public virtual string SelectedText { get; set; }
C#
[Browsable(false)]
[Bindable(true, BindingDirection.TwoWay)]
[ClientControlProperty]
[ClientPropertyName("_selectedValue")]
public virtual string SelectedValue { get; set; }
C#
public virtual string SmartPasteDescription { get; set; }
C#
protected override bool SupportsRenderingMode { get; }

Overrides: RadDataBoundControl.SupportsRenderingMode

TagKey

HtmlTextWriterTag

C#
protected override HtmlTextWriterTag TagKey { get; }

Overrides: ControlItemContainer.TagKey

C#
[ClientControlProperty]
[ClientPropertyName("_uniqueId")]
public override string UniqueID { get; }
C#
public WebServiceSettings WebServiceSettings { get; }
C#
[Bindable(false)]
public int ZIndex { get; set; }

Methods

C#
protected override void AddAttributesToRender(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: RadDataBoundControl.AddAttributesToRender(HtmlTextWriter)

C#
public void ClearSelection()
C#
protected override ControlItemCollection CreateChildItemCollection()
Returns:

ControlItemCollection

Overrides: ControlItemContainer.CreateChildItemCollection()

C#
protected override IRenderer CreateControlRenderer()
Returns:

IRenderer

Overrides: RadDataBoundControl.CreateControlRenderer()

C#
protected override ControlItem CreateItem()
Returns:

ControlItem

Overrides: ControlItemContainer.CreateItem()

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

Overrides: RadDataBoundControl.DescribeClientEvents(IScriptDescriptor)

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

Overrides: RadDataBoundControl.DescribeClientProperties(IScriptDescriptor)

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

Overrides: ControlItemContainer.DescribeComponent(IScriptDescriptor)

C#
public DropDownListItem FindItemByText(string text, bool ignoreCase)
Parameters:textstringignoreCaseboolReturns:

DropDownListItem

C#
public DropDownListItem FindItemByText(string text)
Parameters:textstringReturns:

DropDownListItem

C#
public DropDownListItem FindItemByValue(string value, bool ignoreCase)
Parameters:valuestringignoreCaseboolReturns:

DropDownListItem

C#
public DropDownListItem FindItemByValue(string value)
Parameters:valuestringReturns:

DropDownListItem

C#
public void LoadContentFile(string xmlFileName)
Parameters:xmlFileNamestring
C#
protected override bool LoadPostData(string postDataKey, NameValueCollection postCollection)
Parameters:postDataKeystringpostCollectionNameValueCollectionReturns:

bool

Overrides: RadDataBoundControl.LoadPostData(string, NameValueCollection)

C#
protected virtual void OnItemCreated(DropDownListItemEventArgs e)
Parameters:eDropDownListItemEventArgs
C#
protected void OnItemDataBound(DropDownListItemEventArgs e)
Parameters:eDropDownListItemEventArgs
C#
protected void OnItemSelected(DropDownListEventArgs e)
Parameters:eDropDownListEventArgs
C#
protected void OnSelectedIndexChanged(DropDownListEventArgs e)
Parameters:eDropDownListEventArgs
C#
protected void OnTemplateNeeded(DropDownListItemEventArgs e)
Parameters:eDropDownListItemEventArgs
C#
protected override void PerformDataBinding(IEnumerable data)
Parameters:dataIEnumerable

Overrides: ControlItemContainer.PerformDataBinding(IEnumerable)

C#
protected override void RaiseItemCreated(ControlItem item)
Parameters:itemControlItem

Overrides: ControlItemContainer.RaiseItemCreated(ControlItem)

C#
protected override void RaiseItemDataBound(ControlItem item)
Parameters:itemControlItem

Overrides: ControlItemContainer.RaiseItemDataBound(ControlItem)

C#
protected virtual void RaisePostBackEvent(string eventArgument)
Parameters:eventArgumentstring
C#
protected override void RaiseTemplateNeeded(ControlItem item)
Parameters:itemControlItem

Overrides: ControlItemContainer.RaiseTemplateNeeded(ControlItem)

C#
protected override void RenderContents(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: RadDataBoundControl.RenderContents(HtmlTextWriter)

C#
protected virtual void TrackSelectedIndexChanged(DropDownListEventArgs e)
Parameters:eDropDownListEventArgs

Events

C#
public event DropDownListItemEventHandler ItemCreated
C#
public event DropDownListItemEventHandler ItemDataBound
C#
public event DropDownListEventHandler ItemSelected
C#
public event DropDownListEventHandler SelectedIndexChanged
C#
public event DropDownListItemEventHandler TemplateNeeded
In this article
DefinitionConstructorsRadDropDownList()PropertiesAriaSettingsAutoPostBackClientChangesClientItemTemplateCollapseAnimationCssClassFormatStringDefaultMessageDropDownAutoWidthDropDownHeightDropDownWidthEnableAriaSupportEnableDirectionDetectionEnableScreenBoundaryDetectionEnableVirtualScrollingExpandAnimationExpandDirectionHeightItemCountPerRequestItemsItemTemplateLoadingPanelIDOnClientDropDownClosedOnClientDropDownClosingOnClientDropDownOpenedOnClientDropDownOpeningOnClientItemDataBoundOnClientItemSelectedOnClientItemSelectingOnClientItemsRequestedOnClientItemsRequestFailedOnClientItemsRequestingOnClientLoadOnClientSelectedIndexChangedOnClientTemplateDataBoundSelectedIndexSelectedItemSelectedTextSelectedValueSmartPasteDescriptionSupportsRenderingModeTagKeyUniqueIDWebServiceSettingsZIndexMethodsAddAttributesToRender(HtmlTextWriter)ClearSelection()CreateChildItemCollection()CreateControlRenderer()CreateItem()DescribeClientEvents(IScriptDescriptor)DescribeClientProperties(IScriptDescriptor)DescribeComponent(IScriptDescriptor)FindItemByText(string, bool)FindItemByText(string)FindItemByValue(string, bool)FindItemByValue(string)LoadContentFile(string)LoadPostData(string, NameValueCollection)OnItemCreated(DropDownListItemEventArgs)OnItemDataBound(DropDownListItemEventArgs)OnItemSelected(DropDownListEventArgs)OnSelectedIndexChanged(DropDownListEventArgs)OnTemplateNeeded(DropDownListItemEventArgs)PerformDataBinding(IEnumerable)RaiseItemCreated(ControlItem)RaiseItemDataBound(ControlItem)RaisePostBackEvent(string)RaiseTemplateNeeded(ControlItem)RenderContents(HtmlTextWriter)TrackSelectedIndexChanged(DropDownListEventArgs)EventsItemCreatedItemDataBoundItemSelectedSelectedIndexChangedTemplateNeeded
Not finding the help you need?
Contact Support