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

Telerik.Web.UI.RadComboBox

Remarks

The RadComboBoxcontrol supports the following features: bullet Databinding that allows the control to be populated from various datasourcesProgrammatic access to the RadComboBoxobject model which allows to dynamic creation of comboboxes, populate items, set properties.Customizable appearance through built-in or user-defined skins.ItemsEach item has a P:Telerik.Web.UI.RadComboBoxItem.Text Textand a P:Telerik.Web.UI.RadComboBoxItem.Value Valueproperty. The value of the P:Telerik.Web.UI.RadComboBoxItem.Text Textproperty is displayed in the RadComboBoxcontrol, while the P:Telerik.Web.UI.RadComboBoxItem.Value Valueproperty is used to store any additional data about the item, such as data passed to the postback event associated with the item. You can find information on the server API of RadComboBox at https://docs.telerik.com/devtools/aspnet-ajax/controls/combobox/server-side-programming/events .

Inheritance Hierarchy

  • System.Object
  • System.Web.UI.Control
  • System.Web.UI.WebControls.WebControl
  • System.Web.UI.WebControls.BaseDataBoundControl
  • System.Web.UI.WebControls.DataBoundControl
  • Telerik.Web.UI.RadDataBoundControl : IControl, IControlResolver, IFeatureGroup, IPostBackDataHandler, IScriptControl, ISkinnableControl
  • Telerik.Web.UI.ControlItemContainer : IControlItemContainer, INamingContainer, IXmlSerializable
  • Telerik.Web.UI.RadComboBox : ICallbackEventHandler, IEditableTextControl, IFlatBoundContainer, IPostBackEventHandler, ITextControl

Properties

AccessibilityMode Boolean

Determines whether the noscript tag containing select element to be rendered.

AllowCustomText String

Determines whether custom text can be entered into the input field of RadComboBox.

AriaSettings WaiAriaSettings

Gets the object that controls the Wai-Aria settings applied on the control's element.

AutoCompleteSeparator String

Gets or sets a list of separators: autocomplete logic is reset afer a separator is entered and users can autocomplete multiple items.

Remarks

You can use several separators at once.

AutoPostBack Boolean

Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the RadComboBox selection.

Remarks

Set this property to true if the server needs to capture the selection as soon as it is made. For example, other controls on the Web page can be automatically filled depending on the user's selection from a list control.This property can be used to allow automatic population of other controls on the Web page based on a user's selection from a list.The value of this property is stored in view state. The server-side event that is fired is SelectedIndexChanged.

CausesValidation Boolean

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

Remarks

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.

ChangeTextOnKeyBoardNavigation String

Determines whether the text can be entered into the input field of RadComboBox during keyboard navigation

CheckBoxes Boolean

Gets or sets a value indicating whether the combobox should display the checkboxes for its items.

CheckedItems RadComboBoxItemCollection

Gets the currently checked items in the RadComboBox.

CheckedItemsTexts RadComboBoxItemCollection

Gets or sets a value indicating whether the combobox should display the checked items texts in case they do not fit in the control input.

ClientChanges IList1`

Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred.

Remarks

You can use the ClientChanges property to respond to client-side modifications such as adding a new itemremoving existing itemclearing the children of an item or the control itselfchanging a property of the item The ClientChanges property is available in the first postback (ajax) request after the client-side modifications have taken place. After this moment the property will return empty list.

ClientDataSourceID String

Gets or sets ID of ClientDataSource control that is used for client side binding

ClientIDMode ClientIDMode

This property is overridden in order to support controls which implement INamingContainer. The default value is changed to "AutoID".

ClientItemTemplate ITemplate

Gets or sets the template for displaying the items in RadcomboBox.

CloseDropDownOnBlur Boolean

Determines whether drop down should be closed on blur

CollapseAnimation AnimationSettings

Gets the settings for the animation played when an item closes.

Remarks

Use the CollapseAnimation property to customize the collapse animation of RadComboBox. You can specify the Type, Duration and the items are collapsed. To disable collapse animation effects you should set the Type to AnimationType.None. To customize the expand animation you can use the CollapseAnimation property.

CollapseDelay Int32

Gets or sets a value indicating the timeout after which a dropdown starts to close.

Remarks

Use the CollapseDelay property to delay dropdown closing. To cause immediate item closing set this property to 0 (zero). To customize the timeout prior to item closing use the ExpandDelay property.

ControlId String

The client-side id of the inner input element used for intergation with RadLabel

Controls ControlCollection

Gets a object that represents the child controls for a specified server control in the UI hierarchy.

CssClassFormatString String

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

Culture CultureInfo

Gets or sets the the selected culture. Localization strings will be loaded based on this value.

DataCheckedField String

Gets or sets which datasource field will represent the "Checked" state of an item checkbox.

DefaultItem RadComboBoxDefaultItem

Gets or set the default item in the RadComboBox.

Gets or sets whether to enable/disable the RadComboBox drop down auto width.

Gets or sets an additional Cascading Style Sheet (CSS) class applied to the Drop Down.

Remarks

By default the visual appearance of the Drop Down is defined in the skin CSS file. You can use the DropDownCssClass property to specify a CSS class to be applied in addition to the default CSS class.

Gets or sets the width of the dropdown in pixels.

EmptyMessage String

Gets or sets the empty message.

EnableAjaxSkinRendering String

Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests

Remarks

If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.

EnableAriaSupport Boolean

When set to true enables support for WAI-ARIA.

EnableAutomaticLoadOnDemand Boolean

Gets or sets a value indicating whether the combobox should handle the items request automatically on the server.

EnableCheckAllItemsCheckBox RadComboBoxItemCollection

Gets or sets a value indicating whether the combobox should display the checkboxes for its items.

EnableEmbeddedBaseStylesheet Boolean

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

Remarks

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

EnableEmbeddedScripts Boolean

Gets or sets the value, indicating whether to render script references to the embedded scripts or not.

Remarks

If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.

EnableEmbeddedSkins String

Gets or sets the value, indicating whether to render links to the embedded skins or not.

Remarks

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

EnableItemBindingExpressions Boolean

Gets or sets a value indicating whether any databinding expressions specified in the ItemTemplate should be evaluated for unbound items (items added inline or programmatically).

EnableItemCaching Boolean

Gets or sets a value indicating whether the combobox should cache items loaded on demand or via webservice

EnableLoadOnDemand Boolean

Gets or sets a value indicating whether the combobox should issue a callback to the server whenever end-users change the text of the combo (keypress, paste, etc).

Remarks

In Load On Demand mode, the combobox starts a callback after a specified amount of time (see ItemRequestTimeout) and calls the server-side ItemsRequested event. Depending on the value of the event arguments, you can add new items to the combobox object and the items will be propagated to the browser after the request.

EnableOverlay Boolean

Gets or sets a value indicating whether the Overlay element is rendered when supported. True by default.

EnableRippleEffect Boolean

Returns true if ripple effect should be added

EnableScreenBoundaryDetection Boolean

Determines whether the Screen Boundaries Detection is enabled or not.

EnableTextSelection String

Gets or sets a value indicating whether the text of combobox should be selected

EnableVirtualScrolling Boolean

Gets or sets a value indicating whether the combobox should load items on demand (via callback) during scrolling-down the drop-down area.

ErrorMessage String

Determines the custom error message to be shown after the Load On Demand Callback error appears.

ExpandAnimation AnimationSettings

Gets the settings for the animation played when the dropdown opens.

Remarks

Use the ExpandAnimation property to customize the expand animation of RadComboBox. You can specify the Type, Duration and the To disable expand animation effects you should set the Type to AnimationType.None. To customize the collapse animation you can use the CollapseAnimation property.

ExpandDelay Int32

Gets or sets a value indicating the timeout after which a dropdown starts to open.

Remarks

Use the ExpandDelay property to delay dropdown opening. To customize the timeout prior to item closing use the CollapseDelay property.

ExpandDirection RadComboBoxExpandDirection

Gets or sets a value indicating the opening direction of RadComboBox dropdown. If this property is not set - by default dropdown opens downwards.

Filter RadComboBoxFilter

Gets or sets a value indicating whether the combobox should automatically autocomplete and highlight the currently typed text to the all items text match.

Get a footer of RadcomboBox.

FooterTemplate ITemplate

Gets or sets the template for displaying footer in RadcomboBox.

Get a header of RadcomboBox.

HeaderTemplate ITemplate

Gets or sets the template for displaying header in RadcomboBox.

HighlightTemplatedItems RadComboBoxItemCollection

Gets or sets a value indicating whether items defined in the ItemTemplate template should be automatically highlighted on mouse hover or keyboard navigation.

InputCssClass String

Gets or sets an additional Cascading Style Sheet (CSS) class applied to the Input.

Remarks

By default the visual appearance of the Input is defined in the skin CSS file. You can use the InputCssClass property to specify a CSS class to be applied in addition to the default CSS class.

IsCaseSensitive Boolean

Gets or sets a value that indicates whether the combobox autocompletion logic is case-sensitive or not.

IsEmpty Boolean

Gets a value indicating whether the current instance of the combobox has child items.

IsSkinSet String

For internal use.

ItemRequestTimeout Int32

Specifies the timeout after each keypress before RadComboBox fires an AJAX callback to the ItemsRequested server-side event.

Remarks

In miliseconds. ItemRequestTimeout = 500 is equal to half a second delay.

Items RadComboBoxItemCollection

Gets a RadComboBoxItemCollection object that contains the items of the current RadComboBox control.

Remarks

Use the Items property to access the child items of RadComboBox You can add, remove or modify items from the Items collection.

ItemsPerRequest RadComboBoxItemCollection

Gets or sets the number of Items the RadComboBox will load per Item request.

Remarks

Set this property to -1 to load all Items when EnableAutomaticLoadOnDemand is set to true and disable Virtual Scrolling/Show More Results. The default is -1.

ItemTemplate ITemplate

Gets or sets the template for displaying the items in RadcomboBox.

KeyboardNavigationSettings KeyboardNavigationSettings

Used to customize the keyboard navigation functionality.

Label String

Gets or sets the label of the control.

LabelCssClass String

Gets or sets the css class of the label.

LoadingMessage String

The value of the message that is shown in RadComboBox while AJAX callback call is in effect.

Remarks

This property can be used for customizing and localizing the text of the loading message.

Localization ComboBoxStrings

Gets the localization.

LocalizationPath ComboBoxStrings

Gets or sets a value indicating where RadComboBox will look for its .resx localization files.

MarkFirstMatch Boolean

Gets or sets a value indicating whether the combobox should automatically autocomplete and highlight the currently typed text to the closest item text match.

MaxHeight Unit

Gets or sets the max height of the dropdown in pixels.

MaxLength Int32

Gets or sets the maximum number of characters allowed in the combobox.

MinFilterLength Int32

Gets or sets the minimum length of the typed text before the control initiates a request for new Items when EnableLoadOnDemand is True.

NoWrap Boolean

Gets or sets a value indicating whether the text in a combobox item automatically continues on the next line when it reaches the end of the dropdown.

ODataDataSourceID String

Gets or sets the ODataDataSource used for data binding.

OffsetX Int32

Gets or sets a value indicating the horizontal offset of the combobox dropdown

Remarks

Use the OffsetX property to change the position of the combobox dropdown To customize the vertical offset use the OffsetY property.

OffsetY Int32

Gets or sets a value indicating the vertical offset of the combobox dropdown.

Remarks

Use the OffsetY property to change the position where the combobox dropdown will appear. To customize the horizontal offset use the OffsetX property.

OnClientBlur String

The client-side event that is fired when when the combo loses focus

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args.

OnClientCheckAllChecked String

Gets or sets the name of the JavaScript function which handles the checkAllItemChecked client-side event.

Remarks

The JavaScript function executed when CheckAll checkbox is checked.

OnClientCheckAllChecking String

Gets or sets the name of the JavaScript function which handles the checkAllItemChecked client-side event.

Remarks

The JavaScript function executed before CheckAll checkbox is checked.

OnClientDropDownClosed String

The client-side event that is fired after the dropdown of the combobox is closed.

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args. The event can not be cancelled

OnClientDropDownClosing String

The client-side event that is fired before the dropdown of the combobox is closed.

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args. The event can be cancelled - simply set args.set_cancel to true args.set_cancel(true); from the event handler and the combobox dropdown will not be closed.

OnClientDropDownOpened String

The client-side event that is fired after the dropdown of the combobox is opened.

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args. The event cannot be cancelled.

OnClientDropDownOpening String

The client-side event that is fired before the dropdown of the combobox is opened.

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args. The event can be cancelled - simply set args.set_cancel to true args.set_cancel(true); from the event handler and the combobox dropdown will not be opened.

OnClientFocus String

The client-side event that is fired when when the combo gains focus

Remarks

The event handler receives two parameter: the instance of the combobox client-side object and event args.

OnClientItemChecked String

The client-side event that is fired after a RadComboBox item has been checked.

Remarks

The event handler receives two parameters: the instance of of the combobox client-side object and event argument with the newly checked item.

OnClientItemChecking String

The client-side event that is fired when a RadComboBox item is about to be checked.

Remarks

The event handler receives two parameters: the instance of of the RadComboBox client-side object and event argument of the newly checked item.

                    The event can be cancelled - simply call
                     args.set_cancel(true); 
                    from the event handler and the item will not be changed.

OnClientItemDataBound String

Gets or sets the name of the JavaScript function called when an Item is created during Web Service Load on Demand.

OnClientItemsRequested RadComboBoxItemCollection

Gets or sets a value indicating the client-side event handler that is called when the RadComboBox items were just populated (for example from web service).

Remarks

If specified, the OnClientItemsRequested client-side event handler is called when the RadComboBox items were just populated. Two parameters are passed to the handler:sender, the menu client object;eventArgs, null for this event.This event cannot be cancelled.

OnClientItemsRequestFailed RadComboBoxItemCollection

Gets or sets a value indicating the client-side event handler that is called when the operation for populating the RadComboBox has failed.

Remarks

If specified, the OnClientItemsRequestFailed client-side event handler is called when the operation for populating the RadComboBox has failed. Two parameters are passed to the handler:sender, the menu client object;eventArgs with one property: set_cancel(), set to true to suppress the default action (alert message).This event can be cancelled.

OnClientItemsRequesting RadComboBoxItemCollection

Gets or sets a value indicating the client-side event handler that is called when the RadComboBox is about to be populated (for example from web service).

Remarks

If specified, the OnClientItemsRequesting client-side event handler is called when the RadComboBox is about to be populated. Two parameters are passed to the handler:sender, the menu client object;eventArgs with three properties: get_context(), an user object that will be passed to the web service.set_cancel(), used to cancel the event.This event can be cancelled.

OnClientKeyPressing String

The client-side event that is fired when the user presses a key inside the combobox.

Remarks

The event handler receives two parameters:the instance of the combobox client-side object;browser event arguments.You can use the browser event arguments (and the keyCode property in particular) to detect which key was pressed and to write your own custom logic.

OnClientLoad String

Gets or sets a value indicating the client-side event handler that is called after the RadComboBox client-side object is initialized.

Remarks

If specified, the OnClienLoad client-side event handler is called after the combobox is fully initialized on the client.A single parameter - the combobox client object - is passed to the handler.This event cannot be cancelled.

OnClientSelectedIndexChanged Int32

The client-side event that is fired after the selected index of the RadComboBox has been changed.

Remarks

The event handler receives two parameters: the instance of of the combobox client-side object and event argument with the newly selected item.

OnClientSelectedIndexChanging Int32

The client-side event that is fired when the selected index of the RadComboBox is about to be changed.

Remarks

The event handler receives two parameters: the instance of of the RadComboBox client-side object and event argument of the newly selected item.

                    The event can be cancelled - simply call
                     args.set_cancel(true); 
                    from the event handler and the item will not be changed.

OnClientTemplateDataBound String

Gets or sets the name of the JavaScript function called when the client template for an item is evaluated

OnClientTextChange String

The client-side event that is fired when the selected index of RadCombobox has changed.

OpenDropDownOnLoad Boolean

Gets or sets a value that indicates whether the dropdown of the combobox should be opened by default on loadnig the page.

PostBackUrl String

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

RadComboBoxImagePosition RadComboBoxImagePosition

Sets or gets the position (left or right) of the arrow image dropdown.

Remarks

By default the image is shown on the right. Left can be used in RTL (right-to-left) language scenarios.

RegisterWithScriptManager Boolean

Gets or sets the value, indicating whether to register with the ScriptManager control on the page.

Remarks

If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.

RenderingMode RadComboBoxRenderingMode

Gets or sets a value indicating whether the ComboBox should render as a element.

RenderMode RenderMode

Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css. If the set value is Auto use ResolvedRenderMode to receive the actual RenderMode with respect to the user angent of the current request.

Remarks

Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.

ResolvedRenderMode RenderMode

Returns resolved RenderMode should the original value was Auto

RuntimeSkin String

Gets the real skin name for the control user interface. If Skin is not set, returns "Default", otherwise returns Skin.

SelectedIndex Int32

Gets the index of the currently selected item in the combobox.

SelectedItem RadComboBoxItem

Gets the currently selected item in the combobox.

Remarks

SelectedItem can be null in load-on-demand or AllowCustomText modes. End-users can type any text.

SelectedValue String

Gets the value of the currently selected item in the combobox.

ShowDropDownOnTextboxClick String

Determines whether the dropdown shows when the user clicks in the input field.

ShowMoreResultsBox Boolean

Gets or sets a value indicating whether the combobox should display the box for requesting additional items

ShowToggleImage Boolean

Gets or sets a value indicating whether the dropdown image next to the combobox text area should be displayed.

Remarks

The dropdown image is located in the Skins folder of the combo - by default ~/RadControls/ComboBox/Skins/{SkinName}/DropArrow.gif. You can custmoize or modify the image and place it in the respective folder of the skin you are using.

ShowWhileLoading Boolean

Indicates whether the combobox will be visible while loading.

Skin String

Gets or sets the skin name for the control user interface.

Remarks

If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.

Sort RadComboBoxSort

Automatically sorts items alphabetically (based on the Text property) in ascending or descending order.

SortCaseSensitive RadComboBoxSort

Gets/sets whether the sorting will be case-sensitive or not. By default is set to true.

Text String

Gets or sets the text content of the RadComboBox control.

Remarks

In standard mode, the currently selected text can be accessed using both the Text property or RadCombobox.SelectedItem.Text. In AJAX callback modes, only the Text property can be used because end-users can type or paste text that does not match the text of any item and SelectedItem can be null.

UniqueID String

Gets the unique, hierarchically qualified identifier for the server control.

ValidationGroup String

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

Remarks

This property works only when CausesValidation is set to true.

WebServiceSettings NavigationControlWebServiceSettings

Gets the settings for the web service used to populate items.

Remarks

Use the WebServiceSettings property to configure the web service used to populate items on demand. You must specify both Path and Method to fully describe the service.

                    In order to use the integrated support, the web service should have the following signature:


                    [ScriptService]
                    public class WebServiceName : WebService
                    {
                        [WebMethod]
                        public RadComboBoxItemData[] WebServiceMethodName(object context)
                        {
                            // We cannot use a dictionary as a parameter, because it is only supported by script services.
                            // The context object should be cast to a dictionary at runtime.
                            IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context;

                            //...
                        }
                    }

ZIndex Int32

The HTML Z-index of the items dropdown of RadComboBox.Its default value is 6000.

Remarks

Can be used when the dropdown is to be shown over content with a specified Z-index. If the combobox items dropdown is displayed below the content, set the ZIndex property to a value higher than the value of the HTML content below.

Methods

AddProperty

Adds the property to the IScriptDescriptor, if it's value is different from the given default.

Parameters

descriptor Telerik.Web.UI.IScriptDescriptor

The descriptor to add the property to.

name System.String

The property name.

value System.Object

The current value of the property.

defaultValue System.Object

The default value.

Returns

System.Void

ApplyConditionalRendering

Use this from RenderContents of the inheritor

Returns

System.Void

ClearCheckedItems

Clears the checked items. The property of all items is set to false.

Returns

System.Void

ClearSelection

Clears out the list selection and sets the Selected property of all items to false.

Remarks

Use this method to reset the control so that no items are selected.

Returns

System.Void

ControlPreRender

Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason

Returns

System.Void

CreateDataSourceSelectArguments

Creates a object that is configured for paging if the underlying data source supports it.

Returns

System.Web.UI.DataSourceSelectArguments A initialized for paging if the underlying data source supports it.

DataBind

Binds a data source to the invoked RadComboBox and all its child controls. Does not bind the control if EnableAutomaticLoadOnDemand is true and the page request is not a callback.

Returns

System.Void

DescribeRenderingMode

Should be used by inheritors

Returns

System.Void

FindItem

Returns the first RadComboBoxItem that matches the conditions defined by the specified predicate. The predicate should returns a boolean value.

Parameters

match System.Predicate{Telerik.Web.UI.RadComboBoxItem}

The Predicate <> that defines the conditions of the element to search for.

Returns

Telerik.Web.UI.RadComboBoxItem

FindItemByText

Finds the first RadComboBoxItem with Text that matches the given text value.

Parameters

text System.String

The string to search for.

Returns

Telerik.Web.UI.RadComboBoxItem The first RadComboBoxItem that matches the specified text value.

FindItemByText

Finds the first RadComboBoxItem with Text that matches the given text value.

Parameters

text System.String

The string to search for.

ignoreCase System.Boolean

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

Telerik.Web.UI.RadComboBoxItem The first RadComboBoxItem that matches the specified text value.

FindItemByValue

Finds the first RadComboBoxItem with Value that matches the given value.

Parameters

value System.String

The value to search for.

Returns

Telerik.Web.UI.RadComboBoxItem The first RadComboBoxItem that matches the specified value.

FindItemByValue

Finds the first RadComboBoxItem with Value that matches the given value.

Parameters

value System.String

The value to search for.

ignoreCase System.Boolean

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

Telerik.Web.UI.RadComboBoxItem The first RadComboBoxItem that matches the specified value.

FindItemIndexByText

Returns the index of the first RadComboBoxItem with Text that matches the given text value.

Parameters

text System.String

The string to search for.

Returns

System.Int32

FindItemIndexByText

Returns the index of the first RadComboBoxItem with Text that matches the given text value.

Parameters

text System.String

The string to search for.

ignoreCase System.Boolean

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

System.Int32

FindItemIndexByValue

Returns the index of the first RadComboBoxItem with Value that matches the given value.

Parameters

value System.String

The value to search for.

Returns

System.Int32

FindItemIndexByValue

Returns the index of the first RadComboBoxItem with Value that matches the given value.

Parameters

value System.String

The value to search for.

ignoreCase System.Boolean

A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison).

Returns

System.Int32

GetCheckedIndices

Gets an array containing the indices of the currently checked items in the RadComboBox control.

Returns

System.Int32[]

GetEmbeddedSkinNames

Returns the names of all embedded skins. Used by Telerik.Web.Examples.

Returns

System.Collections.Generic.List1`

GetXml

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

Remarks

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

Returns

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

InternalClearSelection

Legacy. Do not modify. Use only in RadComboBox and RadComboBoxItem classes. Unselects all items (item.Selected = false) and sets SelectedValue = null. It just works as expected in the places where it is used.

Returns

System.Void

LoadClientState

Loads the client state data

Parameters

clientState System.Collections.Generic.Dictionary{System.String,System.Object}

Returns

System.Void

LoadContentFile

Loads combobox items from an XML content file.

Parameters

fileName System.String

The name of the XML file.

Returns

System.Void

LoadPostData

Executed when post data is loaded from the request

Parameters

postDataKey System.String

postCollection System.Collections.Specialized.NameValueCollection

Returns

System.Boolean

LoadXml

Loads the control from an XML string.

Remarks

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

Parameters

xml System.String

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

Returns

System.Void

OnCheckAllCheck

Raises the event.

Parameters

e Telerik.Web.UI.RadComboBoxCheckAllCheckEventArgs

The instance containing the event data.

Returns

System.Void

OnItemChecked

Raises the event.

Parameters

e Telerik.Web.UI.RadComboBoxItemEventArgs

The instance containing the event data.

Returns

System.Void

OnItemCreated

Raises the ItematCreated event.

Parameters

e Telerik.Web.UI.RadComboBoxItemEventArgs

Returns

System.Void

OnItemDataBound

Raises the ItemDataBound event.

Parameters

e Telerik.Web.UI.RadComboBoxItemEventArgs

Returns

System.Void

OnItemsRequested

Raises the ItemRequestEvent event. This allows you to handle the event directly.

Returns

System.Void

OnSelectedIndexChanged

Raises the SelectedIndexChanged event. This allows you to handle the event directly.

Returns

System.Void

OnTextChanged

Raises the TextChanged event. This allows you to handle the event directly.

Returns

System.Void

RaisePostDataChangedEvent

Signals the RadComboBox control to notify the ASP.NET application that the state of the control has changed.

Returns

System.Void

RaisePostDataChangedEvent

Executed when post data changes should invoke a changed event

Returns

System.Void

RaiseTextChandedEvent

Raises the TextChange event. This allows you to handle the event directly.

Returns

System.Void

RegisterCssReferences

Registers the CSS references

Returns

System.Void

RegisterScriptControl

Registers the control with the ScriptManager

Returns

System.Void

RenderBeginTag

Renders the HTML opening tag of the control to the specified writer. This method is used primarily by control developers.

Parameters

writer System.Web.UI.HtmlTextWriter

A that represents the output stream to render HTML content on the client.

Returns

System.Void

RequiresControlState

Override in an inheritor and return false in order to skip Loading/Saving ControlState.

Returns

System.Boolean True

SaveClientState

Saves the client state data

Returns

System.String

SortItems

Sorts the items in the RadComboBox.

Returns

System.Void

SortItems

Sorts the items in the RadComboBox.

Parameters

comparer System.Collections.IComparer

An object from IComparer interface.

Returns

System.Void

In this article