#AdHocDropDownList
##Properties
| Datatype | Property name | Property description | Default Value |
|---|---|---|---|
| String | AccessKey | Gets or sets the access key that allows you to quickly navigate to the Web server control. | String.Empty |
| Boolean | AppendDataBoundItems | Gets or sets a value that indicates whether list items are cleared before data binding. | False |
| String | AppRelativeTemplateSourceDirectory | Gets or sets the application-relative virtual directory of the System.Web.UI.Page or System.Web.UI.UserControl object that contains this control. | String.Empty |
| AttributeCollection | Attributes | Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control. | null |
| Boolean | AutoPostBack | Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection. | False |
| Color | BackColor | Gets or sets the background color of the Web server control. | Color [Empty] |
| Control | BindingContainer | Gets the control that contains this control's data binding. | null |
| Color | BorderColor | Gets or sets the border color of the control. | Color [Empty] |
| BorderStyle | BorderStyle | Gets or sets the border style of the control. | NotSet |
| Unit | BorderWidth | Gets or sets the border width for the control. | String.Empty |
| Boolean | CausesValidation | Gets or sets a value indicating whether validation is performed when a control that is derived from the System.Web.UI.WebControls.ListControl class is clicked. | False |
| String | ClientID | Gets the server control identifier generated by ASP.NET. | String.Empty |
| ClientIDMode | ClientIDMode | Inherit | |
| ControlCollection | Controls | Gets a System.Web.UI.ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. | null |
| Style | ControlStyle | Gets the style of the Web server control. This property is used primarily by control developers. | null |
| Boolean | ControlStyleCreated | Gets a value indicating whether a System.Web.UI.WebControls.Style object has been created for the ControlStyle property. This property is primarily used by control developers. | False |
| String | CssClass | Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client. | String.Empty |
| Control | DataItemContainer | null | |
| Control | DataKeysContainer | null | |
| String | 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. | String.Empty |
| Object | DataSource | Gets or sets the object from which the data-bound control retrieves its list of data items. | null |
| String | DataSourceID | Gets or sets the ID of the control from which the data-bound control retrieves its list of data items. | String.Empty |
| IDataSource | DataSourceObject | null | |
| String | DataTextField | Gets or sets the field of the data source that provides the text content of the list items. | String.Empty |
| String | DataTextFormatString | Gets or sets the formatting string used to control how data bound to the list control is displayed. | String.Empty |
| String | DataValueField | Gets or sets the field of the data source that provides the value of each list item. | String.Empty |
| Boolean | Enabled | Gets or sets a value indicating whether the Web server control is enabled. | True |
| Boolean | EnableTheming | Gets or sets a value indicating whether themes apply to this control. | True |
| Boolean | 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. | True |
| FontInfo | Font | Gets the font properties associated with the Web server control. | null |
| Color | ForeColor | Gets or sets the foreground color (typically the color of the text) of the Web server control. | Color [Empty] |
| Boolean | HasAttributes | Gets a value indicating whether the control has attributes set. | False |
| Unit | Height | Gets or sets the height of the Web server control. | String.Empty |
| String | ID | Gets or sets the programmatic identifier assigned to the server control. | null |
| ListItemCollection | Items | Gets the collection of items in the list control. | null |
| String | ItemType | String.Empty | |
| Control | NamingContainer | Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value. | null |
| Page | Page | Gets a reference to the System.Web.UI.Page instance that contains the server control. | null |
| Control | Parent | Gets a reference to the server control's parent control in the page control hierarchy. | null |
| Version | RenderingCompatibility | 4.0 | |
| Int32 | SelectedIndex | Gets or sets the index of the selected item in the System.Web.UI.WebControls.DropDownList control. | -1 |
| ListItem | SelectedItem | Gets the selected item with the lowest index in the list control. | null |
| String | 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. | String.Empty |
| String | SelectMethod | String.Empty | |
| ISite | Site | Gets information about the container that hosts the current control when rendered on a design surface. | null |
| String | SkinID | Gets or sets the skin to apply to the control. | String.Empty |
| CssStyleCollection | Style | Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control. | null |
| Boolean | SupportsDisabledAttribute | True | |
| Int16 | TabIndex | Gets or sets the tab index of the Web server control. | null |
| TemplateControl | TemplateControl | Gets or sets a reference to the template that contains this control. | null |
| String | TemplateSourceDirectory | Gets the virtual directory of the System.Web.UI.Page or System.Web.UI.UserControl that contains the current server control. | String.Empty |
| String | Text | Gets or sets the SelectedValue property of the System.Web.UI.WebControls.ListControl control. | String.Empty |
| String | ToolTip | Gets or sets the text displayed when the mouse pointer hovers over the Web server control. | String.Empty |
| String | UniqueID | Gets the unique, hierarchically qualified identifier for the server control. | null |
| ValidateRequestMode | ValidateRequestMode | Inherit | |
| String | ValidationGroup | Gets or sets the group of controls for which the control that is derived from the System.Web.UI.WebControls.ListControl class causes validation when it posts back to the server. | String.Empty |
| ViewStateMode | ViewStateMode | Inherit | |
| Boolean | Visible | Gets or sets a value that indicates whether a server control is rendered as UI on the page. | True |
| Unit | Width | Gets or sets the width of the Web server control. | String.Empty |
##Methods
###ApplyStyle(System.Web.UI.WebControls.Style) 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.
Parameters:
- System.Web.UI.WebControls.Style s - A System.Web.UI.WebControls.Style that represents the style to be copied.
###ApplyStyleSheetSkin(System.Web.UI.Page) Applies the style properties defined in the page style sheet to the control.
Parameters:
- System.Web.UI.Page page - The System.Web.UI.Page containing the control.
###ClearSelection() Clears out the list selection and sets the Selected property of all items to false.
###CopyBaseAttributes(System.Web.UI.WebControls.WebControl) Copies the properties not encapsulated by the System.Web.UI.WebControls.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.
Parameters:
- System.Web.UI.WebControls.WebControl controlSrc - A System.Web.UI.WebControls.WebControl that represents the source control with properties to be copied to the Web server control that this method is called from.
###DataBind() Binds a data source to the invoked server control and all its child controls.
###Dispose() Enables a server control to perform final clean up before it is released from memory.
###Equals(System.Object) Determines whether the specified System.Object is equal to the current System.Object.
Parameters:
- System.Object obj - The System.Object to compare with the current System.Object.
Returns:
true if the specified System.Object is equal to the current System.Object; otherwise, false.
###FindControl(System.String) Searches the current naming container for a server control with the specified <paramref name="id parameter.
Parameters:
- System.String id - The identifier for the control to be found.
Returns:
The specified control, or null if the specified control does not exist.
###Focus() Sets input focus to a control.
###GetHashCode() Serves as a hash function for a particular type.
Returns:
A hash code for the current System.Object.
###GetRouteUrl(System.Object)
Parameters:
- System.Object routeParameters
###GetRouteUrl(System.String,System.Object)
Parameters:
- System.String routeName
- System.Object routeParameters
###GetRouteUrl(System.Web.Routing.RouteValueDictionary)
Parameters:
- System.Web.Routing.RouteValueDictionary routeParameters
###GetRouteUrl(System.String,System.Web.Routing.RouteValueDictionary)
Parameters:
- System.String routeName
- System.Web.Routing.RouteValueDictionary routeParameters
###GetType() Gets the System.Type of the current instance.
Returns:
The System.Type instance that represents the exact runtime type of the current instance.
###GetUniqueIDRelativeTo(System.Web.UI.Control)
Parameters:
- System.Web.UI.Control control
###HasControls() Determines if the server control contains any child controls.
Returns:
true if the control contains other controls; otherwise, false.
###MergeStyle(System.Web.UI.WebControls.Style) 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.
Parameters:
- System.Web.UI.WebControls.Style s - A System.Web.UI.WebControls.Style that represents the style to be copied.
###RenderBeginTag(System.Web.UI.HtmlTextWriter) Renders the HTML opening tag of the control to the specified writer. This method is used primarily by control developers.
Parameters:
- System.Web.UI.HtmlTextWriter writer - A System.Web.UI.HtmlTextWriter that represents the output stream to render HTML content on the client.
###RenderControl(System.Web.UI.HtmlTextWriter) Outputs server control content to a provided System.Web.UI.HtmlTextWriter object and stores tracing information about the control if tracing is enabled.
Parameters:
- System.Web.UI.HtmlTextWriter writer - The System.Web.UI.HTmlTextWriter object that receives the control content.
###RenderEndTag(System.Web.UI.HtmlTextWriter) Renders the HTML closing tag of the control into the specified writer. This method is used primarily by control developers.
Parameters:
- System.Web.UI.HtmlTextWriter writer - A System.Web.UI.HtmlTextWriter that represents the output stream to render HTML content on the client.
###ResolveClientUrl(System.String) Gets a URL that can be used by the browser.
Parameters:
- System.String relativeUrl - A URL relative to the current page.
Returns:
A fully qualified URL to the specified resource suitable for use on the browser.
###ResolveUrl(System.String) Converts a URL into one that is usable on the requesting client.
Parameters:
- System.String relativeUrl - The URL associated with the TemplateSourceDirectory property.
Returns:
The converted URL.
###SetRenderMethodDelegate(System.Web.UI.RenderMethod) Assigns an event handler delegate to render the server control and its content into its parent control.
Parameters:
- System.Web.UI.RenderMethod renderMethod - The information necessary to pass to the delegate so that it can render the server control.
###SetTraceData(System.Object,System.Object)
Parameters:
- System.Object traceDataKey
- System.Object traceDataValue
###SetTraceData(System.Object,System.Object,System.Object)
Parameters:
- System.Object tracedObject
- System.Object traceDataKey
- System.Object traceDataValue
###ToString() Returns a System.String that represents the current System.Object.
Returns:
A System.String that represents the current System.Object.