Compartir por

ListBox Clase

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Representa un control de cuadro de lista que permite la selección de uno o varios elementos.

public ref class ListBox : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ValidationProperty("SelectedItem")]
public class ListBox : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackDataHandler
[<System.Web.UI.ValidationProperty("SelectedItem")>]
type ListBox = class
    inherit ListControl
    interface IPostBackDataHandler
Public Class ListBox
Inherits ListControl
Implements IPostBackDataHandler
Herencia
Object
Control
WebControl
ListControl
ListBox
Herencia
Object
Control
WebControl
BaseDataBoundControl
DataBoundControl
ListControl
ListBox
Atributos
ValidationPropertyAttribute
Implementaciones
IPostBackDataHandler

Ejemplos

En el ejemplo siguiente se muestra cómo crear un ListBox 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ListBox Example</title>
<script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         if (ListBox1.SelectedIndex > -1)
            Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

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

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ListBox Example</title>
<script language="VB" runat="server">

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <h3>ListBox Example</h3>

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

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

En el ejemplo siguiente se muestra cómo crear un ListBox control que admita varias selecciones.

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
          string msg = "";
          foreach (ListItem li in ListBox1.Items)
          {
              if (li.Selected)
              {
                  msg += "<BR>" + li.Text + " is selected.";
              }
          }
          Label1.Text = msg;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="Form1" runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Multiple" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <script language="VB" runat="server">

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
            Dim msg As String
            Dim li As ListItem
            msg = ""
            For Each li In ListBox1.Items
                If li.Selected = True Then
                    msg = msg & "<br>" & li.Text & " selected."
                End If
            Next
            Label1.Text = msg
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="Form1" runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Multiple" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

En el ejemplo siguiente se muestra cómo crear un ListBox control a través del enlace de datos.

<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Data Binding ListBox</title>
<script language="C#" runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {

            ArrayList values = new ArrayList();

            values.Add ("Item 1");
            values.Add ("Item 2");
            values.Add ("Item 3");
            values.Add ("Item 4");
            values.Add ("Item 5");
            values.Add ("Item 6");

            ListBox1.DataSource = values;
            ListBox1.DataBind();

         }

      }

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
      
         if ( ListBox1.SelectedIndex > -1 )
            Label1.Text = "You chose: " + ListBox1.SelectedItem.Text;
         
      }

   </script>

</head>
<body>

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

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             Font-Names="Verdana" 
             font-size="10pt" 
             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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Data Binding ListBox</title>
<script language="VB" runat="server">

    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            
            Dim values As New ArrayList()
            
            values.Add("Item 1")
            values.Add("Item 2")
            values.Add("Item 3")
            values.Add("Item 4")
            values.Add("Item 5")
            values.Add("Item 6")
            
            ListBox1.DataSource = values
            ListBox1.DataBind()
        End If 
    End Sub 'Page_Load

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If 
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

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

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             Font-Names="Verdana" 
             font-size="10pt" 
             runat="server"/>

   </form>

</body>
</html>

Comentarios

En este tema:

Introducción

Use el ListBox control para crear un control de lista que permita la selección de uno o varios elementos. Utilice la Rows propiedad para especificar el alto del control. Para habilitar la selección de varios elementos, establezca la SelectionMode propiedad ListSelectionMode.Multipleen .

Para especificar los elementos que desea que aparezcan en el ListBox control, coloque un ListItem elemento para cada entrada entre las etiquetas de apertura y cierre del ListBox control.

Use la Items colección para examinar los ListItem objetos contenidos en el ListBox control . Por ejemplo, puede determinar los elementos seleccionados en el ListBox control enumerando la Items colección y probando el Selected valor de cada ListItem elemento.

El ListBox control también admite el enlace de datos. Para enlazar el control a un origen de datos, cree primero un origen de datos, como uno de los DataSourceControl objetos , que contiene los elementos que se van a mostrar en el control. A continuación, use el DataBind método para enlazar el origen de datos al ListBox control . Use las DataTextField propiedades y DataValueField para especificar qué campo del origen de datos se va a enlazar a las Text propiedades y Value , respectivamente, de cada elemento de lista del control. El ListBox control mostrará ahora la información del origen de datos.

Precaución

Este control se puede usar para mostrar la entrada del usuario, que puede incluir un script de cliente malintencionado. Compruebe cualquier información que se envíe desde un cliente para ver el script ejecutable, las instrucciones SQL u otro código antes de mostrarla en la aplicación. Puede usar controles de validación para comprobar la entrada del usuario antes de mostrar el texto de entrada en un control. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear el script y HTML en la entrada del usuario. Para obtener más información, vea Protección de controles estándar, Protección contra vulnerabilidades de script en una aplicación web mediante la aplicación de codificación HTML en cadenas y validación de la entrada de usuario en ASP.NET páginas web.

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere marcado que se ajuste a los estándares de accesibilidad, consulte Accesibilidad en Visual Studio y ASP.NET y ASP.NET Controles y accesibilidad.

Sintaxis declarativa

<asp:ListBox
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    Rows="integer"
    runat="server"
    SelectedIndex="integer"
    SelectedValue="string"
    SelectionMode="Single|Multiple"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:ListBox>

Constructores

Nombre Description
ListBox()

Inicializa una nueva instancia de la clase ListBox.

Propiedades

Nombre Description
AccessKey

Obtiene o establece la clave de acceso que le permite navegar rápidamente al control de servidor web.

(Heredado de WebControl)
Adapter

Obtiene el adaptador específico del explorador para el control .

(Heredado de Control)
AppendDataBoundItems

Obtiene o establece un valor que indica si los elementos de lista se borran antes del enlace de datos.

(Heredado de ListControl)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o UserControl que contiene este control.

(Heredado de Control)
Attributes

Obtiene la colección de atributos arbitrarios (solo para la representación) que no corresponden a las propiedades del control.

(Heredado de WebControl)
AutoPostBack

Obtiene o establece un valor que indica si un postback en el servidor se produce automáticamente cuando el usuario cambia la selección de lista.

(Heredado de ListControl)
BackColor

Obtiene o establece el color de fondo del control de servidor web.

(Heredado de WebControl)
BindingContainer

Obtiene el control que contiene el enlace de datos de este control.

(Heredado de Control)
BorderColor

Obtiene o establece el color de borde del control.
BorderStyle

Obtiene o establece el estilo de borde del control.
BorderWidth

Obtiene o establece el ancho del borde del control.
CausesValidation

Obtiene o establece un valor que indica si se realiza la validación cuando se hace clic en un control derivado de la ListControl clase .

(Heredado de ListControl)
ChildControlsCreated

Obtiene un valor que indica si se han creado los controles secundarios del control de servidor.

(Heredado de Control)
ClientID

Obtiene el identificador de control para el marcado HTML generado por ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad .

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad .

(Heredado de Control)
Context

Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual.

(Heredado de Control)
Controls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.

(Heredado de Control)
ControlStyle

Obtiene el estilo del control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control.

(Heredado de WebControl)
ControlStyleCreated

Obtiene un valor que indica si se ha creado un Style objeto para la ControlStyle propiedad . Esta propiedad la usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
CssClass

Obtiene o establece la clase Hoja de estilos en cascada (CSS) representada por el control de servidor web en el cliente.

(Heredado de WebControl)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl.

(Heredado de Control)
DataMember

Obtiene o establece la tabla específica de que DataSource se va a enlazar al control .

(Heredado de ListControl)
DataSource

Obtiene o establece el origen de datos que rellena los elementos del control de lista.

(Heredado de ListControl)
DataSourceID

Obtiene o establece el identificador del control desde el que el control enlazado a datos recupera su lista de elementos de datos.

(Heredado de DataBoundControl)
DataSourceObject

Obtiene un objeto que implementa la IDataSource interfaz , que proporciona acceso al contenido de datos del objeto.

(Heredado de DataBoundControl)
DataTextField

Obtiene o establece el campo del origen de datos que proporciona el contenido de texto de los elementos de lista.

(Heredado de ListControl)
DataTextFormatString

Obtiene o establece la cadena de formato utilizada para controlar cómo se muestran los datos enlazados al control de lista.

(Heredado de ListControl)
DataValueField

Obtiene o establece el campo del origen de datos que proporciona el valor de cada elemento de lista.

(Heredado de ListControl)
DesignMode

Obtiene un valor que indica si se usa un control en una superficie de diseño.

(Heredado de Control)
Enabled

Obtiene o establece un valor que indica si el control de servidor web está habilitado.

(Heredado de WebControl)
EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.

(Heredado de WebControl)
EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista y el estado de vista de los controles secundarios que contiene, al cliente solicitante.

(Heredado de Control)
Events

Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura.

(Heredado de Control)
Font

Obtiene las propiedades de fuente asociadas al control de servidor web.

(Heredado de WebControl)
ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.

(Heredado de WebControl)
HasAttributes

Obtiene un valor que indica si el control tiene los atributos establecidos.

(Heredado de WebControl)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada.

(Heredado de Control)
Height

Obtiene o establece el alto del control de servidor web.

(Heredado de WebControl)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.

(Heredado de Control)
IdSeparator

Obtiene el carácter usado para separar los identificadores de control.

(Heredado de Control)
Initialized

Obtiene un valor que indica si se ha inicializado el control enlazado a datos.

(Heredado de BaseDataBoundControl)
IsBoundUsingDataSourceID

Obtiene un valor que indica si la DataSourceID propiedad está establecida.

(Heredado de BaseDataBoundControl)
IsChildControlStateCleared

Obtiene un valor que indica si los controles contenidos en este control tienen estado de control.

(Heredado de Control)
IsDataBindingAutomatic

Obtiene un valor que indica si el enlace de datos es automático.

(Heredado de BaseDataBoundControl)
IsEnabled

Obtiene un valor que indica si el control está habilitado.

(Heredado de WebControl)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor guarda los cambios en su estado de vista.

(Heredado de Control)
IsUsingModelBinders

Obtiene un valor que indica si el enlace de modelos está en uso.

(Heredado de DataBoundControl)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.

(Heredado de Control)
Items

Obtiene la colección de elementos del control de lista.

(Heredado de ListControl)
ItemType

Obtiene o establece el nombre del tipo de elemento de datos para el enlace de datos fuertemente tipado.

(Heredado de DataBoundControl)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista en ID lugar del índice.

(Heredado de Control)
NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad.

(Heredado de Control)
Page

Obtiene una referencia a la Page instancia que contiene el control de servidor.

(Heredado de Control)
Parent

Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
RenderingCompatibility

Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML.

(Heredado de Control)
RequiresDataBinding

Obtiene o establece un valor que indica si se debe llamar al DataBind() método .

(Heredado de BaseDataBoundControl)
Rows

Obtiene o establece el número de filas mostradas en el ListBox control .
SelectArguments

Obtiene un DataSourceSelectArguments objeto que el control enlazado a datos usa al recuperar datos de un control de origen de datos.

(Heredado de DataBoundControl)
SelectedIndex

Obtiene o establece el índice ordinal más bajo de los elementos seleccionados de la lista.

(Heredado de ListControl)
SelectedItem

Obtiene el elemento seleccionado con el índice más bajo del control de lista.

(Heredado de ListControl)
SelectedValue

Obtiene el valor del elemento seleccionado en el control de lista o selecciona el elemento del control de lista que contiene el valor especificado.

(Heredado de ListControl)
SelectionMode

Obtiene o establece el modo de selección del ListBox control.
SelectMethod

Nombre del método al que se va a llamar para leer los datos.

(Heredado de DataBoundControl)
Site

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se va a aplicar al control.

(Heredado de WebControl)
Style

Obtiene una colección de atributos de texto que se representarán como un atributo de estilo en la etiqueta externa del control de servidor web.

(Heredado de WebControl)
SupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer el disabled atributo del elemento HTML representado en "disabled" cuando la propiedad del IsEnabled control es false.

(Heredado de BaseDataBoundControl)
TabIndex

Obtiene o establece el índice de tabulación del control de servidor web.

(Heredado de WebControl)
TagKey

Obtiene el HtmlTextWriterTag valor del ListControl control .

(Heredado de ListControl)
TagName

Obtiene el nombre de la etiqueta de control. Esta propiedad se usa principalmente por los desarrolladores de control.

(Heredado de WebControl)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.

(Heredado de Control)
Text

Obtiene o establece la SelectedValue propiedad del ListControl control .

(Heredado de ListControl)
ToolTip

Obtiene o establece el texto de información sobre herramientas que se muestra cuando el puntero del mouse se sitúa sobre el control.
ToolTip

Obtiene o establece el texto que se muestra cuando el puntero del mouse mantiene el puntero sobre el control de servidor web.

(Heredado de WebControl)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.

(Heredado de Control)
ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos.

(Heredado de Control)
ValidationGroup

Obtiene o establece el grupo de controles para los que el control derivado de la ListControl clase provoca la validación cuando se envía de nuevo al servidor.

(Heredado de ListControl)
ViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo de estado de vista de este 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.

(Heredado de Control)
Width

Obtiene o establece el ancho del control de servidor web.

(Heredado de WebControl)

Métodos

Nombre Description
AddAttributesToRender(HtmlTextWriter)

Agrega name, size, multipley onchange a la lista de atributos que se van a representar.
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la Controls colección del Control objeto .

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor.

(Heredado de Control)
ApplyStyle(Style)

Copia todos los elementos que no sean de marca del estilo especificado en el control Web, sobrescribir los elementos de estilo existentes del control. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica las propiedades de estilo definidas en la hoja de estilos de página al control .

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página.

(Heredado de Control)
ClearCachedClientID()

Establece el valor nullalmacenado en caché en ClientID .

(Heredado de Control)
ClearChildControlState()

Elimina la información de estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildState()

Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildViewState()

Elimina la información de estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
ClearSelection()

Borra la selección de lista y establece la Selected propiedad de todos los elementos en false.

(Heredado de ListControl)
ConfirmInitState()

Establece el estado inicializado del control enlazado a datos.

(Heredado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia las propiedades no encapsuladas por el Style objeto desde el control de servidor web especificado al control de servidor web desde el que se llama a este método. Este método se usa principalmente por los desarrolladores de controles.

(Heredado de WebControl)
CreateChildControls()

Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación.

(Heredado de Control)
CreateControlCollection()

Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor.

(Heredado de Control)
CreateControlStyle()

Crea el objeto de estilo que usa internamente la WebControl clase para implementar todas las propiedades relacionadas con el estilo. Este método se usa principalmente por los desarrolladores de controles.

(Heredado de WebControl)
CreateDataSourceSelectArguments()

Crea un objeto predeterminado DataSourceSelectArguments utilizado por el control enlazado a datos si no se especifica ningún argumento.

(Heredado de DataBoundControl)
DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

(Heredado de Control)
DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

(Heredado de BaseDataBoundControl)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
Dispose()

Permite que un control de servidor realice la limpieza final antes de liberarse de la memoria.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.

(Heredado de Control)
EnsureDataBound()

Llama al DataBind() método si se establece la DataSourceID propiedad y el control enlazado a datos está marcado para requerir el enlace.

(Heredado de BaseDataBoundControl)
EnsureID()

Crea un identificador para los controles que no tienen asignado un identificador.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
FindControl(String, Int32)

Busca en el contenedor de nomenclatura actual un control de servidor con el especificado id y un entero, especificado en el pathOffset parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método.

(Heredado de Control)
FindControl(String)

Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado id .

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.

(Heredado de Control)
GetData()

Recupera un DataSourceView objeto que el control enlazado a datos usa para realizar operaciones de datos.

(Heredado de DataBoundControl)
GetDataSource()

Recupera la IDataSource interfaz con la que está asociado el control enlazado a datos, si existe.

(Heredado de DataBoundControl)
GetDesignModeState()

Obtiene los datos en tiempo de diseño de un control.

(Heredado de Control)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(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.

(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.

(Heredado de Control)
GetSelectedIndices()

Obtiene la matriz de valores de índice para los elementos seleccionados actualmente en el ListBox control .
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte prefijo de la UniqueID propiedad del control especificado.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios.

(Heredado de Control)
IsLiteralContent()

Determina si el control de servidor contiene solo contenido literal.

(Heredado de Control)
LoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método .

(Heredado de Control)
LoadPostData(String, NameValueCollection)

Carga el contenido publicado del control de lista, si es diferente de la última publicación.
LoadViewState(Object)

Carga el estado de vista guardado anteriormente del DetailsView control.

(Heredado de ListControl)
MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.

(Heredado de Control)
MarkAsDataBound()

Establece el estado del control en estado de vista como enlazado correctamente a los datos.

(Heredado de DataBoundControl)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
MergeStyle(Style)

Copia todos los elementos que no sean de marca del estilo especificado en el control Web, pero no sobrescribirán ningún elemento de estilo existente del control. Este método se usa principalmente por los desarrolladores de controles.

(Heredado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página.

(Heredado de Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Genera el evento CreatingModelDataSource.

(Heredado de DataBoundControl)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de ListControl)
OnDataBound(EventArgs)

Genera el evento DataBound.

(Heredado de BaseDataBoundControl)
OnDataPropertyChanged()

Vuelve a enlazar el control enlazado a datos a sus datos después de que cambie una de las propiedades de identificación del origen de datos base.

(Heredado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Genera el evento DataSourceViewChanged.

(Heredado de DataBoundControl)
OnInit(EventArgs)

Genera el evento Init.

(Heredado de Control)
OnInit(EventArgs)

Controla el Init evento.

(Heredado de BaseDataBoundControl)
OnLoad(EventArgs)

Genera el evento Load.

(Heredado de Control)
OnLoad(EventArgs)

Controla el Load evento.

(Heredado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Establece el estado inicializado del control enlazado a datos antes de cargar el control.

(Heredado de DataBoundControl)
OnPreRender(EventArgs)

Configura el ListBox control antes de representarlo en el cliente.
OnSelectedIndexChanged(EventArgs)

Genera el evento SelectedIndexChanged. Esto le permite proporcionar un controlador personalizado para el evento.

(Heredado de ListControl)
OnTextChanged(EventArgs)

Genera el evento TextChanged.

(Heredado de ListControl)
OnUnload(EventArgs)

Genera el evento Unload.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream que se usa para leer un archivo.

(Heredado de Control)
PerformDataBinding(IEnumerable)

Enlaza el origen de datos especificado al control derivado de la ListControl clase .

(Heredado de ListControl)
PerformSelect()

Recupera datos del origen de datos asociado.

(Heredado de ListControl)
RaiseBubbleEvent(Object, EventArgs)

Asigna cualquier origen del evento y su información al elemento primario del control.

(Heredado de Control)
RaisePostDataChangedEvent()

Invoca el OnSelectedIndexChanged(EventArgs) método cada vez que los datos publicados para el ListBox control han cambiado.
RemovedControl(Control)

Se llama después de quitar un control secundario de la Controls colección del Control objeto .

(Heredado de Control)
Render(HtmlTextWriter)

Representa el control en el escritor HTML especificado.

(Heredado de WebControl)
RenderBeginTag(HtmlTextWriter)

Representa la etiqueta de apertura HTML del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles.

(Heredado de WebControl)
RenderChildren(HtmlTextWriter)

Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente.

(Heredado de Control)
RenderContents(HtmlTextWriter)

Representa el contenido del control en el escritor especificado.
RenderContents(HtmlTextWriter)

Representa los elementos del ListControl control .

(Heredado de ListControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter .

(Heredado de Control)
RenderControl(HtmlTextWriter)

Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Representa la etiqueta de cierre HTML del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles.

(Heredado de WebControl)
ResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede usar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que se pueda usar en el cliente solicitante.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor.

(Heredado de Control)
SaveViewState()

Guarda el estado de vista actual del ListControl control -derived y los elementos que contiene.

(Heredado de ListControl)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño de un control.

(Heredado de Control)
SetPostDataSelection(Int32)

Establece la Selected propiedad de un ListItem control después de publicar una página.

(Heredado de ListControl)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario.

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

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento.

(Heredado de Control)
SetTraceData(Object, Object)

Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Marca el punto de partida para comenzar el seguimiento y guardar los cambios de estado de vista en un ListControl control -derived.

(Heredado de ListControl)
ValidateDataSource(Object)

Comprueba que el objeto al que se enlaza un control enlazado a datos es uno con el que puede trabajar.

(Heredado de DataBoundControl)
VerifyMultiSelect()

Determina si el control de lista admite el modo de selección múltiple.

(Heredado de ListControl)

Eventos

Nombre Description
CallingDataMethods

Se produce cuando se llama a los métodos de datos.

(Heredado de DataBoundControl)
CreatingModelDataSource

Se produce cuando se crea el ModelDataSource objeto .

(Heredado de DataBoundControl)
DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
DataBound

Se produce después de que el control de servidor se enlace a un origen de datos.

(Heredado de BaseDataBoundControl)
Disposed

Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET.

(Heredado de Control)
Init

Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el Page objeto .

(Heredado de Control)
PreRender

Se produce después de cargar el Control objeto, pero antes de la representación.

(Heredado de Control)
SelectedIndexChanged

Se produce cuando la selección del control de lista cambia entre publicaciones al servidor.

(Heredado de ListControl)
TextChanged

Se produce cuando cambian las Text propiedades y SelectedValue .

(Heredado de ListControl)
Unload

Se produce cuando el control de servidor se descarga de la memoria.

(Heredado de Control)

Implementaciones de interfaz explícitas

Nombre Description
IAttributeAccessor.GetAttribute(String)

Obtiene un atributo del control Web con el nombre especificado.

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

Establece un atributo del control Web en el nombre y el valor especificados.

(Heredado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.

(Heredado de Control)
IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.

(Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

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

Carga el contenido publicado del control de lista, si es diferente de la última publicación.
IPostBackDataHandler.RaisePostDataChangedEvent()

Invoca el OnSelectedIndexChanged(EventArgs) método cada vez que los datos publicados para el ListBox control han cambiado.

Métodos de extensión

Nombre Description
EnablePersistedSelection(BaseDataBoundControl)
Obsoletos.

Permite que la selección se conserve en los controles de datos que admiten la selección y la paginación.
FindDataSourceControl(Control)

Devuelve el origen de datos asociado al control de datos para el control especificado.
FindFieldTemplate(Control, String)

Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)

Devuelve el objeto de metatable para el control de datos contenedor.

Se aplica a

Consulte también