Exportar (0) Imprimir
Expandir todo

ListControl (Clase)

Actúa como la clase base abstracta que define las propiedades, métodos y eventos comunes a todos los controles de tipo de lista.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

[ControlValuePropertyAttribute("SelectedValue")] 
public abstract class ListControl : DataBoundControl, IEditableTextControl, ITextControl
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
ControlValuePropertyAttribute("SelectedValue") 
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
No aplicable.

No se puede crear directamente una instancia de la clase abstracta ListControl. En lugar de ello, otras clases heredan esta clase como, por ejemplo, las clases CheckBoxList, DropDownList, ListBox y RadioButtonList, y así se proporciona una funcionalidad básica común.

Las propiedades de la clase ListControl permiten especificar el origen de los datos que rellenan el control de lista. Utilice la propiedad DataSource para especificar el origen de datos que se va a enlazar al control de lista. Si el origen de datos contiene más de una tabla, utilice la propiedad DataMember para especificar la tabla que se va a utilizar. Se pueden vincular distintos campos del origen de datos a las propiedades ListItem.Text y ListItem.Value de los elementos del control de lista estableciendo las propiedades DataTextField y DataValueField, respectivamente. Se puede dar formato al texto que se muestra para cada elemento en el control de lista estableciendo la propiedad DataTextFormatString.

Todos los elementos mostrados en el control de lista se almacenan en la colección Items. Utilice la propiedad SelectedIndex para especificar o determinar mediante programación el índice de un elemento seleccionado en el control de lista. Se puede obtener acceso a la propiedad del elemento seleccionado mediante la propiedad SelectedItem.

La clase ListControl proporciona el evento SelectedIndexChanged que se provoca cuando la selección del control de lista cambia valores de un envío a otro envío en el servidor. Esto permite incluir un controlador personalizado para este evento. Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

La clase ListControl implementa la interfaz IEditableTextControl para que los controles de tipo lista derivados se puedan utilizar en el modo de plantilla de otros controles.

El ejemplo de código siguiente muestra cómo seleccionar elementos en un control ListBox. Si el elemento se encuentra en el cuadro de texto, el elemento se selecciona y se muestra un mensaje que indica el nombre del elemento seleccionado. Si no se encuentra el elemento, no se selecciona ningún elemento y se muestra un mensaje que indica que no se encontró el elemento.

Nota de seguridadNota: de seguridad

Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.


<%@ 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 runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }
             
      }

   </script>

</head>

<body>

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

      <h3> ListControl SelectedValue Example </h3>
 
      <asp:ListBox ID="List"
           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:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar:
© 2015 Microsoft