Version

WebDropDown Class Properties

For a list of all members of this type, see WebDropDown members.

Public Properties
 NameDescription
Public PropertyAccessKeyGets or sets the access key that allows you to quickly navigate to the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyActiveItemIndexReturns/sets the active item index in the dropdown item list  
Public PropertyAjaxIndicatorGets reference to container of properties related to ajax indicator.  
Public PropertyAppRelativeTemplateSourceDirectoryGets or sets the application-relative virtual directory of the System.Web.UI.Page or System.Web.UI.UserControl object that contains this control. (Inherited from System.Web.UI.Control)
Public PropertyAttributesGets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyAutoFilterQueryTypeReturns/sets the search query type for auto filtering . By default this is "StartsWith", but it can be anything  
Public PropertyAutoFilterResultSizeReturns/sets the number of items that auto filtering will return

a negative value will reset the auto filter to its default value

 
Public PropertyAutoFilterSortOrderReturns/sets the sorting (ascending or descending) that will be applied on the filtering results .  
Public PropertyAutoFilterTimeoutMswhen we are typing text in the dropdown value display input box, we do not do a postback (filtering) on every key stroke but instead use a timeout and do a postback after this timeout duration. This property allows the developer to configure this timeout  
Public PropertyAutoPostBackReturns/sets AutoPostBack  
Public PropertyAutoPostBackFlagsauto postback flags allow the developer to configure automatic postbacks when some client side events are invoked  
Public PropertyAutoSelectOnMatchIndicates whether matched item will be automatically selected while filtering in the dropdown new property in 9.2  
Public PropertyBackColorOverridden. Background color of control  
Public PropertyBorderColorOverridden. Border color of control  
Public PropertyBorderStyleOverridden. Border style of control  
Public PropertyBorderWidthOverridden. Border width of control  
Public PropertyButtonreturns a reference to the DropDownButton (which is a DisabledImageButton type)  
Public PropertyClientEventsGet reference to the DropDownClientEvents..  
Public PropertyClientIDGets the control ID for HTML markup that is generated by ASP.NET. (Inherited from System.Web.UI.Control)
Public PropertyClientIDModeGets or sets the algorithm that is used to generate the value of the System.Web.UI.Control.ClientID property. (Inherited from System.Web.UI.Control)
Public PropertyClientRenderingTemplateGets or sets the client rendering template.  
Public PropertyClientRenderingTemplateContainerGets the client rendering template container.  
Public PropertyControlsGets a System.Web.UI.ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from System.Web.UI.Control)
Public PropertyControlStyleGets the style of the Web server control. This property is used primarily by control developers. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyControlStyleCreatedGets a value indicating whether a System.Web.UI.WebControls.Style object has been created for the System.Web.UI.WebControls.WebControl.ControlStyle property. This property is primarily used by control developers. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyCssClassGets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyCurrentPagecurrent page index when paging is enabled. Server only property  
Public PropertyCurrentValueReturns/sets the value of the Value display dropdown component

if it is null the empty string will be used

 
Public PropertyCustomAJAXResponseContainer for values passed to client within AJAX response. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyCustomFilterValueGets or sets the custom filter value.  
Public PropertyDataKeyFieldsContains datakeys of the shown data. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyDataMemberGets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Public PropertyDataSourceGets or sets the object from which the data-bound control retrieves its list of data items. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyDataSourceIDOverridden. Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.  
Public PropertyDataSourceObjectGets an object that implements the System.Web.UI.IDataSource interface, which provides access to the object's data content. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Public PropertyDisplayModeReturns/sets the drop down display mode. see DropDownDisplayMode

if set to null the "DropDown" fully-featured mode is used

 
Public PropertyDropDownAnimationDuration  
Public PropertyDropDownAnimationTypeType of the animation : see DropDownAnimationTypes enum  
Public PropertyDropDownContainerHeightReturns/sets the fixed height of the dropdown container itself

If this is zero, the height will grow depending on the number of items in the list

 
Public PropertyDropDownContainerMaxHeightReturns/sets the maximum height to which the value list can grow so that no scroll bars are shown

Setting the value list height to 0 means that contents will grow

 
Public PropertyDropDownContainerWidthReturns/sets the fixed width of the dropdown container itself

if this is zero, or not set at all, the dropdown will be aligned with the value display and the dropdown button (if any)

 
Public PropertyDropDownItemBindingProperty DataBindings are used to map data fields from the database to property values on items in a collection.  
Public PropertyDropDownOffsetXReturns/sets the horizontal offset of the dropdown container relative to the dropdown value display

default (0) means that the dropdown container and the value display will be perfectly aligned horizontally

 
Public PropertyDropDownOffsetYReturns/sets the vertical offset of the dropdown container relative to the dropdown value display

default (0) means that the dropdown container and the value display will be perfectly aligned vertically

 
Public PropertyDropDownOrientationOrientation of the dropdown container relative to the input. See DropDownOrientation enum  
Public PropertyEditorID  
Public PropertyEmptyFilterBehaviorcontrols the filtering functionaltiy when the input is empty (empty string)  
Public PropertyEnableAjaxViewStateGets sets ability to maintain view state of controls on page if their properties were modified while asynchronous postback of this control. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyEnableAnimations  
Public PropertyEnableAutoCompleteFirstMatchIndicates whether while the user is typing, the rest of the first matching item's characters will be displayed selected in the value display box  
Public PropertyEnableAutoFilteringIndicates whether auto filtering will be enabled once the something is typed in the value display  
Public PropertyEnableCachingOnClientWhen caching on the client is performed, if we have already done a filter postback with a specified filter string, the results will be directly obtained from client cache, and no subsequent postbacks will be made  
Public PropertyEnableCaseSensitivityindicates whether matching and autofiltering is case sensitive or not  
Public PropertyEnableClientRenderingIndicates whether the WebDropDown will render itself and perform data-binding purely on the client-side  
Public PropertyEnableClosingDropDownOnBlurif this is set to false, the dropdown container will stay open, even if the control loses focus (set this to false if you want the dropdown to stay open when you scroll for example)  
Public PropertyEnableClosingDropDownOnSelectIndicates whether the drop down container will be closed once an item is selected  
Public PropertyEnableCustomValuesby default this is true. If set to false, the user will not be allowed to type everything in the input box but only when there is a match among the items  
Public PropertyEnableCustomValueSelectionIndicates whether custom values can be selected, once they are persisted and appear in the list  
Public PropertyEnabledOverridden. Whether control is enabled  
Public PropertyEnableDropDownAsChildsets whether the dropdown container will be detached, and absolutely positioned only, or it will be an actual child DOM element of the source element  
Public PropertyEnableEmbeddedJavaScriptInstructs the control to load its embedded Java Script. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyEnableLoadOnDemandIndicates whether load on demand is enabled or not. When load on demand is enabled, the value of pageSize will be automatically used for the row fetch size on each load on demand request  
Public PropertyEnableMarkingMatchedTextthis will enclose matched text fragments with "em" markup by default it's switched off  
Public PropertyEnableMultipleSelectionIndicates whether multiple selection is enabled for items in the drop down container  
Public PropertyEnablePagingReturns/sets an indicator of whether paging is enabled for the item collection in the dropdown container or not  
Public PropertyEnablePersistingCustomValuesIndicates whether custom values entered in the value display should be persisted in the underlying data model or not  
Public PropertyEnableRenderingAnchorswill not render anchors for list items, if set to false  
Public PropertyEnableRightToLeftSupportturns on/off right to left support a boolean value indicating whether right to left support is enabled or not  
Public PropertyEnableThemingGets or sets a value indicating whether themes apply to this control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyEnableViewStateGets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Inherited from System.Web.UI.Control)
Public PropertyFontGets the font properties associated with the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyFooterTemplateAn ITemplate object that will be applied as a template for the footer of the drop down container  
Public PropertyFooterTemplateObject  
Public PropertyForeColorOverridden. Foreground color of control  
Public PropertyHasAttributesGets a value indicating whether the control has attributes set. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyHasDataSourceIndicates whether the Dropdown has a data source assigned to it.  
Public PropertyHeaderTemplateAn ITemplate object that will be applied as a template for the header of the drop down container  
Public PropertyHeaderTemplateObject  
Public PropertyHeightGets or sets the height of the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyIDGets or sets the programmatic identifier assigned to the server control. (Inherited from System.Web.UI.Control)
Public PropertyInsecureSubmitTokensGets sets list of insecure strings as array.

That property is designed to protect application from scripting vulnerability. When request comes from client and the value of the hidden field contains insecure tokens, then all changes on client are discarded. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyInsecureSubmitTokensAsStringGets sets list of insecure strings separated by the "|" character.

That property is designed to protect application from scripting vulnerability. When request comes from client and the value of the hidden field contains insecure tokens, then all changes on client are discarded. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyItemsThe collection of DropDownItems in the WebDropDown.  
Public PropertyItemTemplateAn ITemplate object that will be applied as a template for all items within the control unless an individual Item has a non-null Template property of its own, or it has its TemplateId set to refer to an ItemTemplate in the ItemTemplates collection. (Inherited from Infragistics.Web.UI.ListControls.ListControl)
Public PropertyItemTypeGets or sets the name of the data item type for strongly typed data binding. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Public PropertyKeepFocusOnSelectionIndicates whether input will be automatically re-focused once an item from the dropdown is selected  
Public PropertyLastPageIndexLast page index  
Public PropertyLoadingItemsMessageTemplateAn ITemplate object that will be applied as a template for the loading message for the drop down  
Public PropertyLoadingItemsMessageTemplateObject  
Public PropertyLoadingItemsMessageTextIf this property is set, while items are loaded during AJAX postback, a message will appear notifying that loading is in progress  
Public PropertyMultipleSelectionTypeIndicates the type of multiple selection: Checkbox , keyboard  
Public PropertyMultiSelectValueDelimiterReturns/sets the delimiter for items shown in the value display, when multiple selection is enabled

null will be interpreted as comma

 
Public PropertyNamingContainerGets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same System.Web.UI.Control.ID property value. (Inherited from System.Web.UI.Control)
Public PropertyNullTextnullText is default text that's shown when the control doesn't have focus  
Public PropertyOptimizeCollectionsStateThe collections client state will be stored in the view state and the client collections will not be sent from the client on postback. This will increase page size in terms of view state, but will decrease the postback time numerously, because the collections state will not be uploaded from the client. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyPageGets a reference to the System.Web.UI.Page instance that contains the server control. (Inherited from System.Web.UI.Control)
Public PropertyPageCountTotal pages count  
Public PropertyPagerSettingspager settings  
Public PropertyPageSizeReturns/sets the number of list items on a page , if paging is enabled

page size 0 means that all items will be displayed on the first and only page

 
Public PropertyParentGets a reference to the server control's parent control in the page control hierarchy. (Inherited from System.Web.UI.Control)
Public PropertyRenderer (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyRenderingCompatibilityGets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from System.Web.UI.Control)
Public PropertyRunBot (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertySelectedItemReturns/sets the current selected item. Should be null if multiple selection is enabled  
Public PropertySelectedItemIndexReturns/sets the selected item index in the dropdown item list  
Public PropertySelectedItemsReturns the current list of selected items (applies when multiple selection is enabled)  
Public PropertySelectedValueReturns/sets the text of the currently selected item  
Public PropertySelectMethodThe name of the method to call in order to read data. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Public PropertySiteGets information about the container that hosts the current control when rendered on a design surface. (Inherited from System.Web.UI.Control)
Public PropertySkinIDGets or sets the skin to apply to the control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertySortSQL-like sort expression.  
Public PropertyStyleGets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyStyleSetNameName of the Application Styling Framework(tm) style set defining the themed appearance for this control. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertyStyleSetPathPath containing the Application Styling Framework(tm) style set files for this type of control. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Public PropertySupportsDisabledAttributeGets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's System.Web.UI.WebControls.WebControl.IsEnabled property is false. (Inherited from System.Web.UI.WebControls.BaseDataBoundControl)
Public PropertyTabIndexGets or sets the tab index of the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyTemplateControlGets or sets a reference to the template that contains this control. (Inherited from System.Web.UI.Control)
Public PropertyTemplatesGets a ControlCollection that contains instances of ItemTemplate objects which can be shared among items within the derived Control by seting the Item.TemplateId property to the Id of an ItemTemplate. (Inherited from Infragistics.Web.UI.ListControls.ListControl)
Public PropertyTemplateSourceDirectoryGets the virtual directory of the System.Web.UI.Page or System.Web.UI.UserControl that contains the current server control. (Inherited from System.Web.UI.Control)
Public PropertyTextFieldReturns/sets the field name for multi-column/complex data set, that will be used as the text to shown in the value display box  
Public PropertyToolTipGets or sets the text displayed when the mouse pointer hovers over the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Public PropertyUniqueIDGets the unique, hierarchically qualified identifier for the server control. (Inherited from System.Web.UI.Control)
Public PropertyValidateRequestModeGets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Inherited from System.Web.UI.Control)
Public PropertyValueDisplayTypeReturns/sets the type of input (value display) component. It can be a simple input box, or a complex IG component that conforms to some predefined interface

see DropDownValueDisplayType. null will render a simple input component

 
Public PropertyValueFieldReturns/sets the field name for multi-column/complex data set, that will be used as the value to store in each item in the item list  
Public PropertyViewStateModeGets or sets the view-state mode of this control. (Inherited from System.Web.UI.Control)
Public PropertyVisibleGets or sets a value that indicates whether a server control is rendered as UI on the page. (Inherited from System.Web.UI.Control)
Public PropertyWidthGets or sets the width of the Web server control. (Inherited from System.Web.UI.WebControls.WebControl)
Protected Properties
 NameDescription
Protected PropertyAdapterGets the browser-specific adapter for the control. (Inherited from System.Web.UI.Control)
Protected PropertyChildControlsCreatedGets a value that indicates whether the server control's child controls have been created. (Inherited from System.Web.UI.Control)
Protected PropertyClientIDSeparatorGets a character value representing the separator character used in the System.Web.UI.Control.ClientID property. (Inherited from System.Web.UI.Control)
Protected PropertyEventsGets a list of event handler delegates for the control. This property is read-only. (Inherited from System.Web.UI.Control)
Protected PropertyHasChildViewStateGets a value indicating whether the current server control's child controls have any saved view-state settings. (Inherited from System.Web.UI.Control)
Protected PropertyIdSeparatorGets the character used to separate control identifiers. (Inherited from System.Web.UI.Control)
Protected PropertyInitializedGets a value indicating whether the data-bound control has been initialized. (Inherited from System.Web.UI.WebControls.BaseDataBoundControl)
Protected PropertyIsBoundUsingDataSourceIDGets a value indicating whether the System.Web.UI.WebControls.BaseDataBoundControl.DataSourceID property is set. (Inherited from System.Web.UI.WebControls.BaseDataBoundControl)
Protected PropertyIsTrackingViewStateGets a value that indicates whether the server control is saving changes to its view state. (Inherited from System.Web.UI.Control)
Protected PropertyIsUsingModelBindersGets a value that indicates whether model binding is in use. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Protected PropertyLoadViewStateByIDGets a value indicating whether the control participates in loading its view state by System.Web.UI.Control.ID instead of index. (Inherited from System.Web.UI.Control)
Protected PropertyRequiresDataBindingGets or sets a value indicating whether the System.Web.UI.WebControls.BaseDataBoundControl.DataBind method should be called. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Protected PropertySelectArgumentsGets a System.Web.UI.DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control. (Inherited from System.Web.UI.WebControls.DataBoundControl)
Protected PropertyStyleBotProvides the Control with access to style support services provided by the StyleBot class. By separating these services from the control itself, there is no requirement that a particular control must inherit from a specific base class in order to benefit from the services provided. (Inherited from Infragistics.Web.UI.Framework.Data.FlatDataBoundControl)
Protected PropertyTagKeyGets the System.Web.UI.HtmlTextWriterTag value that corresponds to this Web server control. This property is used primarily by control developers. (Inherited from System.Web.UI.WebControls.WebControl)
Protected PropertyTagNameGets the name of the control tag. This property is used primarily by control developers. (Inherited from System.Web.UI.WebControls.WebControl)
Protected PropertyValueDisplayvalue display ui sub component  
Protected PropertyViewStateGets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (Inherited from System.Web.UI.Control)
Protected PropertyViewStateIgnoresCaseGets a value that indicates whether the System.Web.UI.StateBag object is case-insensitive. (Inherited from System.Web.UI.Control)
See Also