Kendo.Mvc.UI.Fluent.MultiSelectBuilder

Defines the fluent interface for configuring the MultiSelect component.

Methods

AutoBind(System.Boolean)

Controls whether to bind the widget to the DataSource on initialization.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .AutoBind(false)
%>

AutoWidth(System.Boolean)

Controls whether to adjust the popup width

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .AutoWidth(false)
%>

AutoClose(System.Boolean)

Controls whether to close the widget suggestion list on item selection.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .AutoClose(false)
%>

BindTo(System.Collections.Generic.IEnumerable<Kendo.Mvc.UI.DropDownListItem>)

Binds the MultiSelect to a list of DropDownListItem.

Parameters

dataSource System.Collections.Generic.IEnumerable<Kendo.Mvc.UI.DropDownListItem>

The data source.

Example (ASPX)

<%: Html.Telerik().MultiSelect()
    .Name("MultiSelect")
    .BindTo(new List<DropDownListItem>
{
    new DropDownListItem{
    Text = "Text1",
    Value = "Value1"
    },
    new DropDownListItem{
    Text = "Text2",
    Value = "Value2"
    }
})
%>

BindTo(System.Collections.Generic.IEnumerable<System.Web.Mvc.SelectListItem>)

Binds the MultiSelect to a list of SelectListItem.

Parameters

dataSource System.Collections.Generic.IEnumerable<System.Web.Mvc.SelectListItem>

The data source.

Example (ASPX)

<%: Html.Telerik().MultiSelect()
    .Name("MultiSelect")
    .BindTo(new List<SelectListItem>
{
    new SelectListItem{
    Text = "Text1",
    Value = "Value1"
    },
    new SelectListItem{
    Text = "Text2",
    Value = "Value2"
    }
})
%>

ClearButton(System.Boolean)

Use to enable or disable clear button functionality.

Parameters

enable System.Boolean

The boolean value.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .ClearButton(false) //disable clear button
%>

DataValueField(System.String)

Sets the field of the data item that provides the value content of the list items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .DataTextField("Text")
    .DataValueField("Value")
%>

EnforceMinLength(System.Boolean)

If set to true the widget will not show all items when the text of the search input cleared. By default the widget shows all items when the text of the search input is cleared. Works in conjunction with minLength.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .MinLength(3)
    .Filter("contains")
    .EnforceMinLength(true)
%>

Events(System.Action<Kendo.Mvc.UI.Fluent.MultiSelectEventBuilder>)

Configures the client-side events.

Parameters

clientEventsAction System.Action<Kendo.Mvc.UI.Fluent.MultiSelectEventBuilder>

The client events action.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .Events(events =>
        events.Change("change")
    )
%>

Filter(System.String)

Use it to enable filtering of items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .Filter("startswith");
%>

Filter(Kendo.Mvc.UI.FilterType)

Use it to enable filtering of items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .Filter(FilterType.Contains);
%>

Items(System.Action<Kendo.Mvc.UI.Fluent.DropDownListItemFactory>)

Defines the items in the MultiSelect

Parameters

addAction System.Action<Kendo.Mvc.UI.Fluent.DropDownListItemFactory>

The add action.

Example (ASPX)

<%= Html.Telerik().MultiSelect()
    .Name("MultiSelect")
    .Items(items =>
    {
        items.Add().Text("First Item");
        items.Add().Text("Second Item");
    })
%>

HighlightFirst(System.Boolean)

Use it to enable highlighting of first matched item.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .HighlightFirst(true)
%>

Messages(System.Action<Kendo.Mvc.UI.Fluent.MultiSelectMessagesSettingsBuilder>)

The text messages displayed in the widget. Use it to customize or localize the messages.

Parameters

configurator System.Action<Kendo.Mvc.UI.Fluent.MultiSelectMessagesSettingsBuilder>

The action that configures the messages.

MaxSelectedItems(System.Int32)

Specifies the limit of the selected items. If set to null widget will not limit number of the selected items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .MinLength(3)
%>

MinLength(System.Int32)

Specifies the minimum number of characters that should be typed before the widget queries the dataSource.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .MinLength(3)
%>

Placeholder(System.String)

A string that appears in the textbox when it has no value.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .Placeholder("Select country...")
%>

ItemTemplate(System.String)

Template to be used for rendering the items in the list.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .ItemTemplate("#= data #")
%>

ItemTemplateId(System.String)

TemplateId to be used for rendering the items in the list.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .ItemTemplateId("widgetTemplateId")
%>

TagMode(Kendo.Mvc.UI.TagMode)

The mode used to render the selected tags. The available modes are 'single' and 'multiple'

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .TagMode(TagMode.Single)
%>

TagTemplate(System.String)

Template to be used for rendering the tags of the selected items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .TagTemplate("#= data #")
%>

TagTemplateId(System.String)

TemplateId to be used for rendering the tags of the selected items.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .TagTemplateId("widgetTemplateId")
%>

Value(System.Collections.IEnumerable)

Sets the value of the widget.

Example (ASPX)

<%= Html.Kendo().MultiSelect()
    .Name("MultiSelect")
    .Value(new string[] { "1" })
%>