skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • NEW: Design Kits for Figma
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for .NET MAUI UI for Xamarin
    Document Management
    Telerik Document Processing
    Desktop
    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    CMS
    Sitefinity
    UI/UX Tools
    ThemeBuilder
    Debugging
    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Jam FiddlerCap FiddlerCore
    Extended Reality
    UI for Unity XR
    Free Tools
    JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class TelerikDropDownList<TItem, TValue>

The class for the DropDownList component.

Inheritance
System.Object
BaseComponent
DataBoundComponent<TItem>
TelerikSelectBase<TItem, TValue>
TelerikDropDownList<TItem, TValue>
Inherited Members
TelerikSelectBase<TItem, TValue>.OnParametersSetAsync()
TelerikSelectBase<TItem, TValue>.OnInitializedAsync()
TelerikSelectBase<TItem, TValue>.Dispose()
TelerikSelectBase<TItem, TValue>.FocusAsync()
TelerikSelectBase<TItem, TValue>.Open()
TelerikSelectBase<TItem, TValue>.Close()
TelerikSelectBase<TItem, TValue>.IPopupContainer.AddPopupSettings(DropdownPopupSettings)
TelerikSelectBase<TItem, TValue>.IPopupContainer.RemovePopupSettings(DropdownPopupSettings)
TelerikSelectBase<TItem, TValue>.CascadedEditContext
TelerikSelectBase<TItem, TValue>.FloatingLabel
TelerikSelectBase<TItem, TValue>.Id
TelerikSelectBase<TItem, TValue>.ValueField
TelerikSelectBase<TItem, TValue>.TextField
TelerikSelectBase<TItem, TValue>.GroupField
TelerikSelectBase<TItem, TValue>.HeaderTemplate
TelerikSelectBase<TItem, TValue>.FooterTemplate
TelerikSelectBase<TItem, TValue>.NoDataTemplate
TelerikSelectBase<TItem, TValue>.Width
TelerikSelectBase<TItem, TValue>.Filterable
TelerikSelectBase<TItem, TValue>.Title
TelerikSelectBase<TItem, TValue>.AriaLabel
TelerikSelectBase<TItem, TValue>.AriaLabelledBy
TelerikSelectBase<TItem, TValue>.AriaDescribedBy
TelerikSelectBase<TItem, TValue>.ScrollMode
TelerikSelectBase<TItem, TValue>.ItemHeight
TelerikSelectBase<TItem, TValue>.PageSize
TelerikSelectBase<TItem, TValue>.Enabled
TelerikSelectBase<TItem, TValue>.ValueExpression
TelerikSelectBase<TItem, TValue>.ValueChanged
TelerikSelectBase<TItem, TValue>.Value
TelerikSelectBase<TItem, TValue>.TabIndex
TelerikSelectBase<TItem, TValue>.AdaptiveMode
TelerikSelectBase<TItem, TValue>.OnChange
TelerikSelectBase<TItem, TValue>.OnBlur
TelerikSelectBase<TItem, TValue>.FillMode
TelerikSelectBase<TItem, TValue>.Rounded
TelerikSelectBase<TItem, TValue>.Size
TelerikSelectBase<TItem, TValue>.ProcessingData
DataBoundComponent<TItem>.Rebind()
DataBoundComponent<TItem>.Data
BaseComponent.ShouldRender()
BaseComponent.OnInitializedAsync()
BaseComponent.InitLocalizer()
BaseComponent.ThrowIfParameterIsNull(Object, String)
BaseComponent.HaveOptionsChanged(IDictionary<String, Object>, IDictionary<String, Object>)
BaseComponent.GetClassString(String[])
BaseComponent.InvokeAsync<T>(String, Object[])
BaseComponent.InvokeAsync<T>(String, CancellationToken, Object[])
BaseComponent.InvokeVoidAsync(String, Object[])
BaseComponent.InvokeComponentMethodAsync<T>(String, Object[])
BaseComponent.InvokeComponentMethodAsync<T>(String, CancellationToken, Object[])
BaseComponent.InvokeVoidComponentMethodAsync(String, Object[])
BaseComponent.InvokeDisposeAsync()
BaseComponent.StateHasChanged()
BaseComponent.RootComponent
BaseComponent.Class
Namespace: Telerik.Blazor.Components
Assembly: Telerik.Blazor.dll

Syntax

public class TelerikDropDownList<TItem, TValue> : TelerikSelectBase<TItem, TValue>, IDisposable, IPopupContainer, ILabelableInput
Type Parameters
TItem

Type of the model if you cannot provide a Value.

TValue

Type of the Value if you cannot provide a reference to it.

Constructors

TelerikDropDownList()

Declaration
public TelerikDropDownList()

Properties

DefaultText

Creates a default item to be shown when no value is selected. The value is set to default(TValue).

Declaration
public string DefaultText { get; set; }
Property Value
System.String

DropDownListSettings

Defines a renderfragment that contains all settings for the autocomplete. DropDownListPopupSettings.

Declaration
public RenderFragment DropDownListSettings { get; set; }
Property Value
Microsoft.AspNetCore.Components.RenderFragment

FilterDebounceDelay

Time in ms between the last typed symbol and the firing of the internal filter oninput event. Default is 150ms.

Declaration
public int FilterDebounceDelay { get; set; }
Property Value
System.Int32

FilterOperator

Defines the filter operator. Default value is StringFilterOperator.StartsWith.

Declaration
public StringFilterOperator FilterOperator { get; set; }
Property Value
StringFilterOperator

ItemTemplate

Defines the item template of the list items.

Declaration
public RenderFragment<TItem> ItemTemplate { get; set; }
Property Value
Microsoft.AspNetCore.Components.RenderFragment<TItem>

OnClose

Defines the OnClose Event which is fired before the suggestion list of the DropDownList is closed.

Declaration
public EventCallback<DropDownListCloseEventArgs> OnClose { get; set; }
Property Value
Microsoft.AspNetCore.Components.EventCallback<DropDownListCloseEventArgs>

OnItemRender

Fires each time an item in dropdown renders. Use the event to add a custom CSS class to each dropdown item based on its value.

Declaration
public Action<DropDownListItemRenderEventArgs<TItem>> OnItemRender { get; set; }
Property Value
System.Action<DropDownListItemRenderEventArgs<TItem>>

OnOpen

Defines the OnOpen Event which is fired before the suggestion list of the DropDownList is opened.

Declaration
public EventCallback<DropDownListOpenEventArgs> OnOpen { get; set; }
Property Value
Microsoft.AspNetCore.Components.EventCallback<DropDownListOpenEventArgs>

OnRead

Fires when the data source is read. Use this to attach your own filtering logic. Once attached, you must implement all such data source operations here, the Component will no longer perform them for you.

Declaration
public EventCallback<DropDownListReadEventArgs> OnRead { get; set; }
Property Value
Microsoft.AspNetCore.Components.EventCallback<DropDownListReadEventArgs>

SelectedDataItem

Declaration
protected ListDataItem SelectedDataItem { get; set; }
Property Value
Telerik.Blazor.Components.Common.Dropdowns.ListDataItem

TextField

Defines the TextField of the Data. Default value: "Text".

Declaration
public override string TextField { get; set; }
Property Value
System.String

Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.TextField

ValueMapper

A callback function that returns an item that corresponds to the argument value. Used in virtual scrolling combined with OnRead to facilitate pre-selection of items that are not currently loaded.

Declaration
public Func<TValue, Task<TItem>> ValueMapper { get; set; }
Property Value
System.Func<TValue, System.Threading.Tasks.Task<TItem>>

ValueTemplate

Defines the value template of the DropDownList.

Declaration
public RenderFragment<TItem> ValueTemplate { get; set; }
Property Value
Microsoft.AspNetCore.Components.RenderFragment<TItem>

Methods

BuildRenderTree(RenderTreeBuilder)

Declaration
protected override void BuildRenderTree(RenderTreeBuilder __builder)
Parameters
Microsoft.AspNetCore.Components.Rendering.RenderTreeBuilder __builder

Dispose()

Declaration
public override void Dispose()
Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.Dispose()

HandleAltArrowUpShortcutAsync()

Declaration
protected override Task HandleAltArrowUpShortcutAsync()
Returns
System.Threading.Tasks.Task

Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.HandleAltArrowUpShortcutAsync()

HandleEscapeKeyAsync()

Declaration
protected override Task HandleEscapeKeyAsync()
Returns
System.Threading.Tasks.Task

Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.HandleEscapeKeyAsync()

OnAfterRenderAsync(Boolean)

Declaration
protected override Task OnAfterRenderAsync(bool firstRender)
Parameters
System.Boolean firstRender

Returns
System.Threading.Tasks.Task

Overrides
BaseComponent.OnAfterRenderAsync(Boolean)

OnParametersSetAsync()

Declaration
protected override Task OnParametersSetAsync()
Returns
System.Threading.Tasks.Task

Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.OnParametersSetAsync()

SetParametersAsync(ParameterView)

Declaration
public override Task SetParametersAsync(ParameterView parameters)
Parameters
Microsoft.AspNetCore.Components.ParameterView parameters

Returns
System.Threading.Tasks.Task

Overrides
Telerik.Blazor.Components.Common.TelerikSelectBase<TItem, TValue>.SetParametersAsync(Microsoft.AspNetCore.Components.ParameterView)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Client-side Blazor
  • Server-side Blazor
  • Demos
Community
  • Forums
  • Blogs
  • Feedback Portal
Support Resources
  • Demos
  • Knowledge Base
  • Samples Repo
  • Localizations Repo
Sample Applications
  • Dashboard
  • PWA - Stocks
  • PWA - Blazing Coffee Roasters

Copyright © 2019 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.