HtmlSelect Clase

Definición

Permite el acceso mediante programación al elemento HTML <select> en el servidor.Allows programmatic access to the HTML <select> element on the server.

public ref class HtmlSelect : System::Web::UI::HtmlControls::HtmlContainerControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ValidationProperty("Value")]
public class HtmlSelect : System.Web.UI.HtmlControls.HtmlContainerControl, System.Web.UI.IPostBackDataHandler
type HtmlSelect = class
    inherit HtmlContainerControl
    interface IPostBackDataHandler
    interface IParserAccessor
Public Class HtmlSelect
Inherits HtmlContainerControl
Implements IPostBackDataHandler
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo HtmlSelect crear un control declarando explícitamente los elementos que aparecen en el control.The following code example demonstrates how to create an HtmlSelect control by explicitly declaring the items that appear in the control.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    void Button_Click (Object sender, EventArgs e)
    {
        
        Label1.Text = "You selected:";

        for (int i = 0; i <= Select1.Items.Count - 1; i++)
        {
           if (Select1.Items[i].Selected)
              Label1.Text += "<br /> &nbsp;&nbsp; -" + Select1.Items[i].Text;
        }

    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
    
    <h3> HtmlSelect Example </h3>

    Select items from the list: <br /><br />

    <select id="Select1" 
            multiple="true"
            runat="server">

        <option value="1" selected="selected"> Item 1 </option>
        <option value="2"> Item 2 </option>
        <option value="3"> Item 3 </option>
        <option value="4"> Item 4 </option>
        <option value="5"> Item 5 </option>
        <option value="6"> Item 6 </option>

    </select>
    <br /><br />

    <button id="Button1"
            onserverclick="Button_Click"
            runat="server">

        Submit

    </button>
    <br /><br />

    <asp:Label id="Label1"
         runat="server"/>

   </form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Sub Button_Click (sender As Object, e As EventArgs)
        
        Dim i As Integer

        Label1.Text = "You selected:"
        For i = 0 to Select1.Items.Count - 1
  
            If Select1.Items(i).Selected Then
               Label1.Text = Label1.Text & "<br /> &nbsp;&nbsp; -" _
                   & Select1.Items(i).Text
            End If         

        Next i

    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">

    <h3> HtmlSelect Example </h3>

    Select items from the list: <br /><br />

    <select id="Select1" 
            multiple="true"
            runat="server">

        <option value="1" selected="selected"> Item 1 </option>
        <option value="2"> Item 2 </option>
        <option value="3"> Item 3 </option>
        <option value="4"> Item 4 </option>
        <option value="5"> Item 5 </option>
        <option value="6"> Item 6 </option>

    </select>
    <br /><br />

    <button id="Button1"
            onserverclick="Button_Click"
            runat="server">

        Submit

    </button>
    <br /><br />

    <asp:Label id="Label1"
         runat="server"/>

   </form>
</body>
</html>

En el ejemplo de código siguiente se muestra cómo HtmlSelect crear un control enlazando el control a un origen de datos.The following code example demonstrates how to create an HtmlSelect control by binding the control to a data source.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
<script runat="server">

      void Page_Load (Object sender, EventArgs e)
      {

        // Bind the HtmlSelect control to a data source when the page is initially loaded.
        if (!IsPostBack)
        {
      
           // Open a connection to the database and run the query.
           // Note that the connection string may vary depending on your
           // database server settings. 
           string ConnectString = "server=localhost;database=pubs;integrated security=SSPI";
           string QueryString = "select * from authors";

           SqlConnection myConnection = new SqlConnection(ConnectString);
           SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection);

           // Create a dataset to store the query results.
           DataSet ds = new DataSet();
           myCommand.Fill(ds, "Authors");

           // Bind the HtmlSelect control to the data source.
           Select1.DataSource = ds;
           Select1.DataTextField = "au_fname";
           Select1.DataValueField = "au_fname";
           Select1.DataBind();
        }

      }

      void Button_Click (Object sender, EventArgs e)
      {
       
         // Display the selected items. 
         Label1.Text = "You selected:";

         for (int i=0; i<=Select1.Items.Count - 1; i++)
         {
            if (Select1.Items[i].Selected)
               Label1.Text += "<br /> &nbsp;&nbsp; - " + Select1.Items[i].Text;
         }

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlSelect Example </h3>

      Select items from the list. <br />
      Use the Control or Shift key to select multiple items. <br /><br />

      <select id="Select1"
              multiple="true" 
              runat="server"/>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
<script runat="server">

      Sub Page_Load (sender As Object, e As EventArgs)
  
        ' Bind the HtmlSelect control to a data source when the page is initially loaded.
        If Not IsPostBack Then
        
           ' Open a connection to the database and run the query.
           ' Note that the connection string may vary depending on your
           ' database server settings.
           Dim ConnectString As String = "server=localhost;database=pubs;integrated security=SSPI"
           Dim QueryString As String = "select * from authors"

           Dim myConnection As SqlConnection = New SqlConnection(ConnectString)
           Dim myCommand As SqlDataAdapter = New SqlDataAdapter(QueryString, myConnection)

           ' Create a dataset to store the query results.
           Dim ds As DataSet = New DataSet()
           myCommand.Fill(ds, "Authors")

           ' Bind the HtmlSelect control to the data source.
           Select1.DataSource = ds
           Select1.DataTextField = "au_fname"
           Select1.DataValueField = "au_fname"
           Select1.DataBind()
        
        End If

      End Sub

      Sub Button_Click (sender As Object, e As EventArgs)
        
         Dim i As Integer

         Label1.Text = "You selected:"

         For i = 0 To Select1.Items.Count - 1
         
            If Select1.Items(i).Selected Then
               Label1.Text = Label1.Text & "<br /> &nbsp;&nbsp; - " & Select1.Items(i).Text
            End If

         Next i

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlSelect Example </h3>

      Select items from the list. <br />
      Use the Control or Shift key to select multiple items. <br /><br />

      <select id="Select1"
              multiple="true" 
              runat="server"/>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>

En el ejemplo de código siguiente se muestra cómo DataSourceID utilizar la propiedad para especificar el origen de HtmlSelect datos de un control.The following code example demonstrates how to use the DataSourceID property to specify the data source for an HtmlSelect control. La DataSourceID propiedad se establece en la ID propiedad del SqlDataSource control que se utiliza para recuperar los datos.The DataSourceID property is set to the ID property of the SqlDataSource control used to retrieve the data. Cuando se carga la página, el HtmlSelect control se enlaza automáticamente al origen de datos especificado por el SqlDataSource control y los datos se muestran al usuario.When the page is loaded, the HtmlSelect control automatically binds to the data source specified by the SqlDataSource control and the data is displayed to the user.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>
<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

Comentarios

Utilice el HtmlSelect control para crear un cuadro de selección.Use the HtmlSelect control to create a selection box. Especifique las listas de elementos en el control colocando elementos HTML <option> entre las etiquetas de apertura y cierre. <select>Specify item listings in the control by placing HTML <option> elements between the opening and closing <select> tags. Cada elemento se representa mediante un System.Web.UI.WebControls.ListItem objeto.Each item is represented by a System.Web.UI.WebControls.ListItem object. Para especificar el texto que se muestra para cada elemento en el control, puede establecer la ListItem.Text propiedad del elemento o simplemente colocar texto entre las etiquetas de apertura y de cierre. <option>To specify the text that is displayed for each item in the control, you can set the ListItem.Text property of the item, or simply place text between the opening and closing <option> tags. Al establecer la ListItem.Value propiedad del elemento, puede asociar un valor al elemento que sea diferente del texto.By setting the ListItem.Value property of the item, you can associate a value with the item that is different from the text. Para seleccionar un elemento de la lista de forma predeterminada, establezca ListItem.Selected la propiedad del elemento en true.To select an item from the list by default, set the ListItem.Selected property of the item to true.

Puede controlar la apariencia y el comportamiento del HtmlSelect control estableciendo las Size propiedades y Multiple .You can control the appearance and behavior of the HtmlSelect control by setting the Size and Multiple properties. La Size propiedad especifica el alto (en filas) del control.The Size property specifies the height (in rows) of the control. La Multiple propiedad especifica si se puede seleccionar más de un elemento simultáneamente en el HtmlSelect control.The Multiple property specifies whether more than one item can be concurrently selected in the HtmlSelect control.

De forma predeterminada, HtmlSelect el control se muestra como un cuadro de lista desplegable.By default, the HtmlSelect control is displayed as a drop-down list box. Multiple Si permite selecciones múltiples (estableciendo la propiedad en true) o especifica un alto mayor que una fila (estableciendo la Size propiedad en un valor mayor que 1), el control se muestra como un cuadro de lista.If you allow multiple selections (by setting the Multiple property to true) or specify a height greater than one row (by setting the Size property to a value greater than 1), the control is displayed as a list box.

Para determinar el elemento seleccionado en un control de selección HtmlSelect única, utilice la SelectedIndex propiedad para obtener el índice del elemento seleccionado.To determine the selected item in a single-selection HtmlSelect control, use the SelectedIndex property to get the index of the selected item. Después, puede usar este valor para recuperar el elemento de la Items colección.You can then use this value to retrieve the item from the Items collection.

Para determinar los elementos seleccionados desde un HtmlSelect control que permite selecciones múltiples, recorra en Items iteración la colección ListItem.Selected y pruebe la propiedad de cada elemento.To determine the selected items from an HtmlSelect control that allows multiple selections, iterate through the Items collection and test the ListItem.Selected property of each item.

La HtmlSelect clase proporciona dos propiedades para admitir el enlace de datos.The HtmlSelect class provides two properties to support data binding. Para enlazar datos a cualquier objeto que implemente System.Collections.IEnumerable la interfaz ( System.Data.DataViewcomo, System.Collections.ArrayListy System.Collections.Generic.List<T>), o la IListSource interfaz, utilice la DataSource propiedad para especificar el origen de datos con el que se va a enlazar.To bind data to any object that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, and System.Collections.Generic.List<T>), or the IListSource interface, use the DataSource property to specify the data source to bind to. Al establecer la DataSource propiedad, debe escribir manualmente el código para realizar el enlace de datos.When you set the DataSource property, you must manually write the code to perform the data binding. Para enlazar automáticamente HtmlSelect un control a un origen de datos representado por un control de origen de DataSourceID datos, utilice la propiedad y establezca ID su valor en la propiedad del control de origen de datos que se va a usar.To automatically bind an HtmlSelect control to a data source represented by a data source control, use the DataSourceID property and set its value to the ID property of the data source control to use. Cuando se establece la DataSourceID propiedad, el HtmlSelect control se enlaza automáticamente al control de origen de datos especificado.When you set the DataSourceID property, the HtmlSelect control automatically binds to the specified data source control. Por lo tanto, no es necesario llamar explícitamente DataBind al método.Therefore, you do not need to explicitly call the DataBind method.

También puede especificar qué campos del origen de datos se enlazan a ListItem.Text las ListItem.Value propiedades y de un elemento del control estableciendo las DataTextField propiedades y DataValueField , respectivamente.You can also specify which fields in the data source bind to the ListItem.Text and ListItem.Value properties of an item in the control by setting the DataTextField and DataValueField properties, respectively. Si el origen de datos contiene varios orígenes de datos, utilice DataMember la propiedad para especificar el origen específico que se va a enlazar al control.If the data source contains multiple sources of data, use the DataMember property to specify the specific source to bind to the control. Por ejemplo, si tiene un System.Data.DataSet objeto con varias tablas, debe especificar la tabla que se va a enlazar al control con la DataMember propiedad.For example, if you have a System.Data.DataSet object with multiple tables, you must specify which table to bind to the control with the DataMember property.

Para obtener una lista de los valores de propiedad iniciales de HtmlSelectuna instancia de HtmlSelect , vea el constructor.For a list of initial property values for an instance of HtmlSelect, see the HtmlSelect constructor.

Constructores

HtmlSelect()

Inicializa una nueva instancia de la clase HtmlSelect.Initializes a new instance of the HtmlSelect class.

Propiedades

Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Heredado de Control)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Heredado de Control)
Attributes

Obtiene una colección de todos los pares de nombre y valor de atributo expresados en una etiqueta de control de servidor en la página ASP.NET.Gets a collection of all attribute name and value pairs expressed on a server control tag within the ASP.NET page.

(Heredado de HtmlControl)
BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Heredado de Control)
ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Heredado de Control)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Heredado de Control)
Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Heredado de Control)
Controls

Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Heredado de Control)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Heredado de Control)
DataMember

Obtiene o establece el conjunto de datos que se va a enlazar al control HtmlSelect desde una propiedad DataSource con varios conjuntos de datos.Gets or sets the set of data to bind to the HtmlSelect control from a DataSource property with multiple sets of data.

DataSource

Obtiene o establece el origen de información que se va a enlazar al control HtmlSelect.Gets or sets the source of information to bind to the HtmlSelect control.

DataSourceID

Obtiene o establece la propiedad ID del control de origen de datos que debe utilizar el control HtmlSelect para recuperar su origen de datos.Gets or sets the ID property of the data source control that the HtmlSelect control should use to retrieve its data source.

DataTextField

Obtiene o establece el campo del origen de datos que se va a enlazar a la propiedad Text de cada elemento del control HtmlSelect.Gets or sets the field from the data source to bind to the Text property of each item in the HtmlSelect control.

DataValueField

Obtiene o establece el campo del origen de datos que se va a enlazar a la propiedad Value de cada elemento del control HtmlSelect.Gets or sets the field from the data source to bind to the Value property of each item in the HtmlSelect control.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Heredado de Control)
Disabled

Obtiene o establece un valor que indica si el control de servidor HTML está deshabilitado.Gets or sets a value indicating whether the HTML server control is disabled.

(Heredado de HtmlControl)
EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.Gets or sets a value indicating whether themes apply to this control.

(Heredado de Control)
EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.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.

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Heredado de Control)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Heredado de Control)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Heredado de Control)
InnerHtml

Obtiene o establece el contenido que se encuentra entre las etiquetas de apertura y cierre del control, sin convertir automáticamente los caracteres especiales en entidades HTML equivalentes.Gets or sets the content between the opening and closing tags of the control without automatically converting special characters to their equivalent HTML entities. Esta propiedad no es compatible con este control.This property is not supported for this control.

InnerText

Obtiene o establece el contenido que se encuentra entre las etiquetas de apertura y cierre del control, con la conversión automática de los caracteres especiales en entidades HTML equivalentes.Gets or sets the content between the opening and closing tags of the control with automatic conversion of special characters to their equivalent HTML entities. Esta propiedad no es compatible con este control.This property is not supported for this control.

IsBoundUsingDataSourceID

Obtiene un valor que indica se ha definido una propiedad DataSourceID para el control HtmlSelect.Gets a value indicating whether a DataSourceID property is defined for the HtmlSelect control.

IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Heredado de Control)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Heredado de Control)
Items

Obtiene una colección que contiene los elementos incluidos en un control HtmlSelect.Gets a collection that contains the items listed in an HtmlSelect control.

LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Heredado de Control)
Multiple

Obtiene o establece un valor que indica si se puede seleccionar varios elementos simultáneamente en el control HtmlSelect.Gets or sets a value indicating whether multiple items can be selected concurrently in the HtmlSelect control.

Name

Obtiene o establece el nombre del identificador único asociado al control HtmlSelect.Gets or sets the unique identifier name associated with the HtmlSelect control.

NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.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.

(Heredado de Control)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Heredado de Control)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Heredado de Control)
RequiresDataBinding

Obtiene o establece un valor que indica si el control HtmlSelect necesita enlazarse a su origen de datos especificado.Gets or sets a value indicating whether the HtmlSelect control needs to bind to its specified data source.

SelectedIndex

Obtiene o establece el índice ordinal del elemento seleccionado en un control HtmlSelect.Gets or sets the ordinal index of the selected item in an HtmlSelect control.

SelectedIndices

Obtiene una colección que contiene los índices de base cero de todos los elementos que están seleccionados actualmente en el control HtmlSelect.Gets a collection that contains the zero-based indexes of all currently selected items in the HtmlSelect control.

Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Heredado de Control)
Size

Obtiene o establece el alto (en filas) del control HtmlSelect.Gets or sets the height (in rows) of the HtmlSelect control.

SkinID

Obtiene o establece la máscara que se aplica al control.Gets or sets the skin to apply to the control.

(Heredado de Control)
Style

Obtiene una colección de todas las propiedades de hojas de estilos en cascada (CSS) que se aplican a un determinado control de servidor HTML en el archivo de ASP.NET.Gets a collection of all cascading style sheet (CSS) properties applied to a specified HTML server control in the ASP.NET file.

(Heredado de HtmlControl)
TagName

Obtiene el nombre de elemento de una etiqueta que contiene un par de valor y atributo runat=server.Gets the element name of a tag that contains a runat=server attribute and value pair.

(Heredado de HtmlControl)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Heredado de Control)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Heredado de Control)
ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Heredado de Control)
Value

Obtiene el valor del elemento seleccionado en el control HtmlSelect o establece la propiedad SelectedIndex del control en el índice del primer elemento de la lista que tenga el valor especificado.Gets the value of the selected item in the HtmlSelect control or sets the SelectedIndex property of the control to the index of the first item in the list with the specified value.

ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.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.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el estado de vista HtmlControl hace distinción entre mayúsculas y minúsculas.Gets a value that indicates whether the HtmlControl view state is case-sensitive.

(Heredado de HtmlControl)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Heredado de Control)

Métodos

AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Heredado de Control)
AddParsedSubObject(Object)

Agrega un control secundario analizado al control HtmlSelect.Adds a parsed child control to the HtmlSelect control.

ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Heredado de Control)
ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Heredado de Control)
ClearSelection()

Borra la selección de lista del control HtmlSelect y establece la propiedad Selected de todos los elementos en false.Clears the list selection of the HtmlSelect control and sets the Selected property of all items to false.

CreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.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.

(Heredado de Control)
CreateControlCollection()

Crea un objeto EmptyControlCollection para el control HtmlSelect.Creates an EmptyControlCollection object for the HtmlSelect control.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

(Heredado de Control)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Heredado de Control)
Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Heredado de Control)
EnsureDataBound()

Comprueba que el control HtmlSelect requiere el enlace de datos y que se ha especificado un control de origen de datos válido antes de llamar al método DataBind().Verifies that the HtmlSelect control requires data binding and that a valid data source control is specified before calling the DataBind() method.

EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Heredado de Control)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.Sets input focus to a control.

(Heredado de Control)
GetAttribute(String)

Obtiene el valor del atributo con nombre en el control HtmlControl.Gets the value of the named attribute on the HtmlControl control.

(Heredado de HtmlControl)
GetData()

Obtiene un objeto IEnumerable que representa el origen de datos enlazado al control HtmlSelect.Gets an IEnumerable object that represents the data source that is bound to the HtmlSelect control.

GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Heredado de Control)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Heredado de Control)
IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Heredado de Control)
LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Heredado de Control)
LoadPostData(String, NameValueCollection)

Procesa los datos de postback para el control HtmlSelect.Processes the postback data for the HtmlSelect control.

LoadViewState(Object)

Restaura la información sobre el estado de vista del control HtmlSelect de una solicitud de página anterior guardada por el método SaveViewState().Restores the HtmlSelect control's view state information from a previous page request that was saved by the SaveViewState() method.

MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Heredado de Control)
OnDataBinding(EventArgs)

Provoca el evento DataBinding de un control HtmlSelect.Raises the DataBinding event of an HtmlSelect control.

OnDataPropertyChanged()

Se invoca cuando cambia la propiedad DataSource, DataMember o DataSourceID.Invoked when the DataSource, DataMember, or DataSourceID property is changed.

OnDataSourceViewChanged(Object, EventArgs)

Se invoca cuando cambia la propiedad DataSource, DataMember o DataSourceID.Invoked when the DataSource, DataMember, or DataSourceID property is changed.

OnInit(EventArgs)

Genera el evento Init para el control HtmlSelect.Raises the Init event for the HtmlSelect control.

OnLoad(EventArgs)

Genera el evento Load para el control HtmlSelect.Raises the Load event for the HtmlSelect control.

OnPreRender(EventArgs)

Genera el evento PreRender para el control HtmlSelect.Raises the PreRender event for the HtmlSelect control.

OnServerChange(EventArgs)

Provoca el evento ServerChange del control HtmlSelect.Raises the ServerChange event of the HtmlSelect control. Esto permite incluir un control personalizado para el evento.This allows you to provide a custom handler for the event.

OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Heredado de Control)
RaisePostDataChangedEvent()

Llama al método OnServerChange(EventArgs) para indicar al control HtmlSelect que el estado del control ha cambiado.Calls the OnServerChange(EventArgs) method to signal the HtmlSelect control that the state of the control has changed.

RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Heredado de Control)
Render(HtmlTextWriter)

Representa el control HtmlContainerControl en el objeto HtmlTextWriter especificado.Renders the HtmlContainerControl control to the specified HtmlTextWriter object.

(Heredado de HtmlContainerControl)
RenderAttributes(HtmlTextWriter)

Representa los atributos del control HtmlSelect en el objeto HtmlTextWriter especificado.Renders the HtmlSelect control's attributes to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el objeto HtmlTextWriter especificado.Renders the opening HTML tag of the control into the specified HtmlTextWriter object.

(Heredado de HtmlControl)
RenderChildren(HtmlTextWriter)

Representa los controles secundarios del control HtmlSelect en el objeto HtmlTextWriter especificado.Renders the HtmlSelect control's child controls to the specified HtmlTextWriter object.

RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Representa la etiqueta de cierre del control HtmlContainerControl en el objeto HtmlTextWriter especificado.Renders the closing tag for the HtmlContainerControl control to the specified HtmlTextWriter object.

(Heredado de HtmlContainerControl)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Heredado de Control)
SaveViewState()

Guarda los cambios que se hayan producido en el estado de vista del control HtmlSelect desde la devolución de la página al servidor.Saves any HtmlSelect control view state changes that have occurred since the page was posted back to the server.

Select(Int32[])

Selecciona varios elementos de la colección HtmlSelect del control Items.Selects multiple items of the HtmlSelect control's Items collection.

SetAttribute(String, String)

Obtiene el valor del atributo con nombre en el control HtmlControl.Sets the value of the named attribute on the HtmlControl control.

(Heredado de HtmlControl)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Heredado de Control)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Heredado de Control)
SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TrackViewState()

Realiza el seguimiento de los cambios del estado de vista del control HtmlSelect para que los cambios se puedan almacenar en su objeto StateBag.Tracks view state changes to the HtmlSelect control so the changes can be stored in the control's StateBag object. Este objeto es accesible a través de la propiedad ViewState.This object is accessible through the ViewState property.

Eventos

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Heredado de Control)
Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.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.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Heredado de Control)
PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Heredado de Control)
ServerChange

Se produce cuando los elementos seleccionados del control HtmlSelect cambian entre cada envío al servidor.Occurs when the selected items in the HtmlSelect control change between posts to the server.

Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Heredado de Control)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)

Para una descripción de este miembro, vea GetAttribute(String).For a description of this member, see GetAttribute(String).

(Heredado de HtmlControl)
IAttributeAccessor.SetAttribute(String, String)

Para una descripción de este miembro, vea SetAttribute(String, String).For a description of this member, see SetAttribute(String, String).

(Heredado de HtmlControl)
IControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Heredado de Control)
IExpressionsAccessor.Expressions

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Heredado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Para obtener una descripción de este miembro, vea LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Para obtener una descripción de este miembro, vea RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent().

Métodos de extensión

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

Se aplica a

Consulte también: