Export (0) Print
Expand All

ListBox Members

Represents a list box control that allows single or multiple item selection.

The following tables list the members exposed by the ListBox type.

  Name Description
Public method ListBox Initializes a new instance of the ListBox class.
Top

(see also Protected Properties )
  Name Description
Public property AccessKey  Gets or sets the access key that allows you to quickly navigate to the Web server control.(inherited from WebControl)
Public property AppendDataBoundItems  Gets or sets a value that indicates whether list items are cleared before data binding.(inherited from ListControl)
Public property AppRelativeTemplateSourceDirectory  Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.(inherited from Control)
Public property Attributes  Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.(inherited from WebControl)
Public property AutoPostBack  Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.(inherited from ListControl)
Public property BackColor  Gets or sets the background color of the Web server control.(inherited from WebControl)
Public property BindingContainer  Gets the control that contains this control's data binding.(inherited from Control)
Public property BorderColor Gets or sets the border color of the control.
Public property BorderStyle Gets or sets the border style of the control.
Public property BorderWidth Gets or sets the border width for the control.
Public property CausesValidation  Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.(inherited from ListControl)
Public property ClientID  Gets the server control identifier generated by ASP.NET.(inherited from Control)
Public property Controls  Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.(inherited from Control)
Public property ControlStyle  Gets the style of the Web server control. This property is used primarily by control developers.(inherited from WebControl)
Public property ControlStyleCreated  Gets a value indicating whether a Style object has been created for the ControlStyle property. This property is primarily used by control developers.(inherited from WebControl)
Public property CssClass  Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.(inherited from WebControl)
Public property DataMember  Gets 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 DataBoundControl)
Public property DataSource  Gets or sets the object from which the data-bound control retrieves its list of data items.(inherited from BaseDataBoundControl)
Public property DataSourceID  Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.(inherited from DataBoundControl)
Public property DataTextField  Gets or sets the field of the data source that provides the text content of the list items.(inherited from ListControl)
Public property DataTextFormatString  Gets or sets the formatting string used to control how data bound to the list control is displayed.(inherited from ListControl)
Public property DataValueField  Gets or sets the field of the data source that provides the value of each list item.(inherited from ListControl)
Public property Enabled  Gets or sets a value indicating whether the Web server control is enabled.(inherited from WebControl)
Public property EnableTheming  Gets or sets a value indicating whether themes apply to this control.(inherited from WebControl)
Public property EnableViewState  Gets 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 Control)
Public property Font  Gets the font properties associated with the Web server control.(inherited from WebControl)
Public property ForeColor  Gets or sets the foreground color (typically the color of the text) of the Web server control.(inherited from WebControl)
Public property HasAttributes  Gets a value indicating whether the control has attributes set.(inherited from WebControl)
Public property Height  Gets or sets the height of the Web server control.(inherited from WebControl)
Public property ID  Gets or sets the programmatic identifier assigned to the server control.(inherited from Control)
Public property Items  Gets the collection of items in the list control.(inherited from ListControl)
Public property NamingContainer  Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same Control.ID property value.(inherited from Control)
Public property Page  Gets a reference to the Page instance that contains the server control.(inherited from Control)
Public property Parent  Gets a reference to the server control's parent control in the page control hierarchy.(inherited from Control)
Public property Rows Gets or sets the number of rows displayed in the ListBox control.
Public property SelectedIndex  Gets or sets the lowest ordinal index of the selected items in the list.(inherited from ListControl)
Public property SelectedItem  Gets the selected item with the lowest index in the list control.(inherited from ListControl)
Public property SelectedValue  Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.(inherited from ListControl)
Public property SelectionMode Gets or sets the selection mode of the ListBox control.
Public property Site  Gets information about the container that hosts the current control when rendered on a design surface.(inherited from Control)
Public property SkinID  Gets or sets the skin to apply to the control.(inherited from WebControl)
Public property Style  Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.(inherited from WebControl)
Public property TabIndex  Gets or sets the tab index of the Web server control.(inherited from WebControl)
Public property TemplateControl  Gets or sets a reference to the template that contains this control. (inherited from Control)
Public property TemplateSourceDirectory  Gets the virtual directory of the Page or UserControl that contains the current server control.(inherited from Control)
Public property Text  Gets or sets the SelectedValue property of the ListControl control.(inherited from ListControl)
Public property ToolTip  Gets or sets the text displayed when the mouse pointer hovers over the Web server control.(inherited from WebControl)
Public property UniqueID  Gets the unique, hierarchically qualified identifier for the server control.(inherited from Control)
Public property ValidationGroup  Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server. (inherited from ListControl)
Public property Visible  Gets or sets a value that indicates whether a server control is rendered as UI on the page.(inherited from Control)
Public property Width  Gets or sets the width of the Web server control.(inherited from WebControl)
Top

  Name Description
Protected property Adapter  Gets the browser-specific adapter for the control.(inherited from Control)
Protected property ChildControlsCreated  Gets a value that indicates whether the server control's child controls have been created.(inherited from Control)
Protected property ClientIDSeparator  Gets a character value representing the separator character used in the ClientID property.(inherited from Control)
Protected property Context  Gets the HttpContext object associated with the server control for the current Web request.(inherited from Control)
Protected property DesignMode  Gets a value indicating whether a control is being used on a design surface.(inherited from Control)
Protected property Events  Gets a list of event handler delegates for the control. This property is read-only.(inherited from Control)
Protected property HasChildViewState  Gets a value indicating whether the current server control's child controls have any saved view-state settings.(inherited from Control)
Protected property IdSeparator  Gets the character used to separate control identifiers.(inherited from Control)
Protected property Initialized  Gets a value indicating whether the data-bound control has been initialized.(inherited from BaseDataBoundControl)
Protected property IsBoundUsingDataSourceID  Gets a value indicating whether the DataSourceID property is set.(inherited from BaseDataBoundControl)
Protected property IsChildControlStateCleared  Gets a value indicating whether controls contained within this control have control state.(inherited from Control)
Protected property IsEnabled  Gets a value indicating whether the control is enabled.(inherited from WebControl)
Protected property IsTrackingViewState  Gets a value that indicates whether the server control is saving changes to its view state.(inherited from Control)
Protected property IsViewStateEnabled  Gets a value indicating whether view state is enabled for this control.(inherited from Control)
Protected property LoadViewStateByID  Gets a value indicating whether the control participates in loading its view state by ID instead of index. (inherited from Control)
Protected property RequiresDataBinding  Gets or sets a value indicating whether the DataBind method should be called. (inherited from BaseDataBoundControl)
Protected property SelectArguments  Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control. (inherited from DataBoundControl)
Protected property TagKey  Gets the HtmlTextWriterTag value for the ListControl control. (inherited from ListControl)
Protected property TagName  Gets the name of the control tag. This property is used primarily by control developers.(inherited from WebControl)
Protected property ViewState  Gets 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 Control)
Protected property ViewStateIgnoresCase  Gets a value that indicates whether the StateBag object is case-insensitive.(inherited from Control)
Top

(see also Protected Methods )
  Name Description
Public method ApplyStyle  Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. This method is primarily used by control developers. (inherited from WebControl)
Public method ApplyStyleSheetSkin  Applies the style properties defined in the page style sheet to the control. (inherited from Control)
Public method ClearSelection  Clears out the list selection and sets the Selected property of all items to false. (inherited from ListControl)
Public method CopyBaseAttributes  Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. This method is used primarily by control developers. (inherited from WebControl)
Public method DataBind  Overloaded. Binds a data source to the invoked server control and all its child controls. (inherited from BaseDataBoundControl)
Public method Dispose  Enables a server control to perform final clean up before it is released from memory. (inherited from Control)
Public method Equals  Overloaded. Determines whether two Object instances are equal. (inherited from Object)
Public method FindControl  Overloaded. Searches the current naming container for the specified server control. (inherited from Control)
Public method Focus  Sets input focus to a control. (inherited from Control)
Public method GetHashCode  Serves as a hash function for a particular type. (inherited from Object)
Public method GetSelectedIndices Gets the array of index values for currently selected items in the ListBox control.
Public method GetType  Gets the Type of the current instance. (inherited from Object)
Public method HasControls  Determines if the server control contains any child controls. (inherited from Control)
Public method MergeStyle  Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. This method is used primarily by control developers. (inherited from WebControl)
Public method Static ReferenceEquals  Determines whether the specified Object instances are the same instance. (inherited from Object)
Public method RenderBeginTag  Renders the HTML opening tag of the control to the specified writer. This method is used primarily by control developers. (inherited from WebControl)
Public method RenderControl  Overloaded. Outputs server control content and stores tracing information about the control if tracing is enabled. (inherited from Control)
Public method RenderEndTag  Renders the HTML closing tag of the control into the specified writer. This method is used primarily by control developers. (inherited from WebControl)
Public method ResolveClientUrl  Gets a URL that can be used by the browser. (inherited from Control)
Public method ResolveUrl  Converts a URL into one that is usable on the requesting client. (inherited from Control)
Public method SetRenderMethodDelegate  Assigns an event handler delegate to render the server control and its content into its parent control. (inherited from Control)
Public method ToString  Returns a String that represents the current Object. (inherited from Object)
Top

  Name Description
Protected method AddAttributesToRender Overridden. Adds name, size, multiple, and onchange to the list of attributes to render.
Protected method AddedControl  Called after a child control is added to the Controls collection of the Control object. (inherited from Control)
Protected method AddParsedSubObject  Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object. (inherited from Control)
Protected method BuildProfileTree  Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (inherited from Control)
Protected method ClearChildControlState  Deletes the control-state information for the server control's child controls. (inherited from Control)
Protected method ClearChildState  Deletes the view-state and control-state information for all the server control's child controls. (inherited from Control)
Protected method ClearChildViewState  Deletes the view-state information for all the server control's child controls. (inherited from Control)
Protected method ConfirmInitState  Sets the initialized state of the data-bound control. (inherited from BaseDataBoundControl)
Protected method CreateChildControls  Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (inherited from Control)
Protected method CreateControlCollection  Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control. (inherited from Control)
Protected method CreateControlStyle  Creates the style object that is used internally by the WebControl class to implement all style related properties. This method is used primarily by control developers. (inherited from WebControl)
Protected method CreateDataSourceSelectArguments  Creates a default DataSourceSelectArguments object used by the data-bound control if no arguments are specified. (inherited from DataBoundControl)
Protected method DataBind  Overloaded. Binds a data source to the invoked server control and all its child controls. (inherited from Control)
Protected method DataBindChildren  Binds a data source to the server control's child controls. (inherited from Control)
Protected method EnsureChildControls  Determines whether the server control contains child controls. If it does not, it creates child controls. (inherited from Control)
Protected method EnsureDataBound  Calls the DataBind method if the DataSourceID property is set and the data-bound control is marked to require binding. (inherited from BaseDataBoundControl)
Protected method EnsureID  Creates an identifier for controls that do not have an identifier assigned. (inherited from Control)
Protected method Finalize  Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (inherited from Object)
Protected method FindControl  Overloaded. Searches the current naming container for the specified server control. (inherited from Control)
Protected method GetData  Retrieves a DataSourceView object that the data-bound control uses to perform data operations. (inherited from DataBoundControl)
Protected method GetDataSource  Retrieves the IDataSource interface that the data-bound control is associated with, if any. (inherited from DataBoundControl)
Protected method GetDesignModeState  Gets design-time data for a control. (inherited from Control)
Protected method HasEvents  Returns a value indicating whether events are registered for the control or any child controls. (inherited from Control)
Protected method IsLiteralContent  Determines if the server control holds only literal content. (inherited from Control)
Protected method LoadControlState  Restores control-state information from a previous page request that was saved by the SaveControlState method. (inherited from Control)
Protected method LoadPostData Loads the posted content of the list control, if it is different from the last posting.
Protected method LoadViewState  Loads the previously saved view state of the DetailsView control. (inherited from ListControl)
Protected method MapPathSecure  Retrieves the physical path that a virtual path, either absolute or relative, maps to. (inherited from Control)
Protected method MarkAsDataBound  Sets the state of the control in view state as successfully bound to data. (inherited from DataBoundControl)
Protected method MemberwiseClone  Creates a shallow copy of the current Object. (inherited from Object)
Protected method OnBubbleEvent  Determines whether the event for the server control is passed up the page's UI server control hierarchy. (inherited from Control)
Protected method OnDataBinding  Raises the DataBinding event. (inherited from ListControl)
Protected method OnDataBound  Raises the DataBound event. (inherited from BaseDataBoundControl)
Protected method OnDataPropertyChanged  Rebinds the data-bound control to its data after one of the base data source identification properties changes. (inherited from DataBoundControl)
Protected method OnDataSourceViewChanged  Raises the DataSourceViewChanged event. (inherited from DataBoundControl)
Protected method OnInit  Handles the Init event. (inherited from BaseDataBoundControl)
Protected method OnLoad  Handles the Control.Load event. (inherited from DataBoundControl)
Protected method OnPagePreLoad  Sets the initialized state of the data-bound control before the control is loaded. (inherited from DataBoundControl)
Protected method OnPreRender Overridden. Configures the ListBox control prior to rendering on the client.
Protected method OnSelectedIndexChanged  Raises the SelectedIndexChanged event. This allows you to provide a custom handler for the event. (inherited from ListControl)
Protected method OnTextChanged  Raises the TextChanged event. (inherited from ListControl)
Protected method OnUnload  Raises the Unload event. (inherited from Control)
Protected method OpenFile  Gets a Stream used to read a file. (inherited from Control)
Protected method PerformDataBinding  Binds the specified data source to the control that is derived from the ListControl class. (inherited from ListControl)
Protected method PerformSelect  Retrieves data from the associated data source. (inherited from ListControl)
Protected method RaiseBubbleEvent  Assigns any sources of the event and its information to the control's parent. (inherited from Control)
Protected method RaisePostDataChangedEvent Invokes the OnSelectedIndexChanged method whenever posted data for the ListBox control has changed.
Protected method RemovedControl  Called after a child control is removed from the Controls collection of the Control object. (inherited from Control)
Protected method Render  Renders the control to the specified HTML writer. (inherited from WebControl)
Protected method RenderChildren  Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (inherited from Control)
Protected method RenderContents  Renders the items in the ListControl control. (inherited from ListControl)
Protected method RenderControl  Overloaded. Outputs server control content and stores tracing information about the control if tracing is enabled. (inherited from Control)
Protected method ResolveAdapter  Gets the control adapter responsible for rendering the specified control. (inherited from Control)
Protected method SaveControlState  Saves any server control state changes that have occurred since the time the page was posted back to the server. (inherited from Control)
Protected method SaveViewState  Saves the current view state of the ListControl -derived control and the items it contains. (inherited from ListControl)
Protected method SetDesignModeState  Sets design-time data for a control. (inherited from Control)
Protected method SetPostDataSelection  Sets the Selected property of a ListItem control after a page is posted. (inherited from ListControl)
Protected method TrackViewState  Marks the starting point to begin tracking and saving view-state changes to a ListControl -derived control. (inherited from ListControl)
Protected method ValidateDataSource  Verifies that the object a data-bound control binds to is one it can work with. (inherited from DataBoundControl)
Protected method VerifyMultiSelect  Determines whether the list control supports multiselection mode. (inherited from ListControl)
Top

  Name Description
Public event DataBinding  Occurs when the server control binds to a data source.(inherited from Control)
Public event DataBound  Occurs after the server control binds to a data source.(inherited from BaseDataBoundControl)
Public event Disposed  Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.(inherited from Control)
Public event Init  Occurs when the server control is initialized, which is the first step in its lifecycle.(inherited from Control)
Public event Load  Occurs when the server control is loaded into the Page object.(inherited from Control)
Public event PreRender  Occurs after the Control object is loaded but prior to rendering.(inherited from Control)
Public event SelectedIndexChanged  Occurs when the selection from the list control changes between posts to the server.(inherited from ListControl)
Public event TextChanged  Occurs when the Text and SelectedValue properties change.(inherited from ListControl)
Public event Unload  Occurs when the server control is unloaded from memory.(inherited from Control)
Top

  Name Description
Explicit interface implementation Method System.Web.UI.IPostBackDataHandler.LoadPostData Loads the posted content of the list control, if it is different from the last posting.
Explicit interface implementation Method System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent Invokes the OnSelectedIndexChanged method whenever posted data for the ListBox control has changed.
Top

Community Additions

ADD
Show:
© 2014 Microsoft