Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe ListBox

Representa um controle de caixa de listagem que permita único ou seleção múltipla do item.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

[ValidationPropertyAttribute("SelectedItem")]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ListBox : ListControl, IPostBackDataHandler
<asp:ListBox />

Use o ListBox controle para criar um controle de lista que permite a único ou seleção múltipla do item. Use o Rows propriedade para especificar a altura do controle. Para ativar a seleção múltipla do item, defina o SelectionMode propriedade para ListSelectionMode.Multiple.

Use o Items coleção para examinar a ListItem objetos contidos na ListBox controle. Por exemplo, você pode determinar os itens selecionados no ListBox controle, enumerando a Items coleção e testar o Selected valor para cada ListItem elemento.

Observação de cuidadoCuidado:

Este controle pode ser usado para exibir a entrada do usuário, que pode incluir script cliente mal-intencionado.Verifique quaisquer informações que são enviadas de um cliente para o script executável, instruções SQL ou Outros código antes de exibi-la em seu aplicativo. Você pode usar controles de validação para verificar a entrada do usuário antes de exibir o texto de entrada em um controle. O ASP.NET fornece um recurso de validação de solicitação de entrada para o bloco de script e HTML na entrada do usuário.Para obter mais informações, consulte Protegendo controles padrão, Como: Proteger contra scripts maliciosos em um aplicativo da Web aplicando codificação HTML nas Seqüências de caracteres, e Validando Entrada de Usuário em Páginas da Web ASP.NET.

Acessibilidade

A marcação processada por padrão para este controle pode atendem aos padrões de acessibilidade, como as diretrizes Prioridade 1 Web conteúdo acessibilidade diretrizes 1.0 (WCAG) não.Para obter detalhes sobre o suporte de acessibilidade para esse controle, consulte Controles ASP.NET e acessibilidade.

TopicLocation
Como: Definir a seleção na lista de Servidor Web controles (Visual Studio)dv_vwdcon
Demonstra Passo a passo: Criando elementos Reusable com controles de usuário do ASP.NETdv_vwdcon
Demonstra Passo a passo: Criando e usando ASP.NET Mestre páginas em Visual Web Developerdv_vwdcon
Como: Responder a alterações na lista da Servidor Web controlesdv_aspnetcon
Como: Preencher Lista Servidor Web controles de uma fonte de dados (Visual Studio)dv_vwdcon
Como: Adicionar caixa de listagem Servidor Web controles a uma página Web Forms (Visual Studio)dv_vwdcon
Como: Set Foco on ASP.NET Servidor Web Controlesdv_aspnetcon
Demonstra Passo a passo: Dados de vinculação a um Personalizar Business objetodv_vwdcon
Como: Adicionar itens na lista de Servidor Web controles (Visual Studio)dv_vwdcon
Como: Determine the Seleção in Lista Servidor Web Controlesdv_aspnetcon
Como: Add to a Page Web Formulários ListBox Servidor Web Controlesdv_aspnetcon
Como: Populate Lista Servidor Web Controles from a Source Dadosdv_aspnetcon
Como: SeleçãoSSeleçãoeSeleçãotSeleção SeleçãotSeleçãohSeleçãoeSeleção SeleçãoSSeleçãoeSeleçãolSeleçãoeSeleçãocSeleçãotSeleçãoiSeleçãooSeleçãonSeleção SeleçãoiSeleçãonSeleção SeleçãoLSeleçãoiSeleçãosSeleçãotSeleçãoaSeleção SeleçãoWSeleçãoeSeleçãobSeleção SeleçãoCSeleçãooSeleçãonSeleçãotSeleçãorSeleçãooSeleçãolSeleçãosSeleção SeleçãoSSeleçãoeSeleçãorSeleçãovSeleçãoeSeleçãorSeleçãodv_aspnetcon
Como: Adicionar itens na lista da Servidor Web controlesdv_aspnetcon
Como: conjunto a seleção em controles de lista do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Responder a alterações na lista de controles do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar controles de servidor Web ListBox a uma página de Web FormsBuilding ASP .NET Web Applications in Visual Studio
Como: conjunto o foco em controles de servidor Web do ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: popular a lista servidor Web controles a partir de fontes de dadosBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Ligação para um objeto de negócios personalizado de dadosBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar itens em controles de lista do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Determine the seleção in lista servidor Web ControlsBuilding ASP .NET Web Applications in Visual Studio
Como: conjunto a seleção em controles de lista do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Responder a alterações na lista de controles do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar controles de servidor Web ListBox a uma página de Web FormsBuilding ASP .NET Web Applications in Visual Studio
Como: conjunto o foco em controles de servidor Web do ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: popular a lista servidor Web controles a partir de fontes de dadosBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Ligação para um objeto de negócios personalizado de dadosBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar itens em controles de lista do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Determine the seleção in lista servidor Web ControlsBuilding ASP .NET Web Applications in Visual Studio

O exemplo a seguir demonstra como criar um ListBox controle.

<%@ 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>


O exemplo a seguir demonstra como criar um ListBox controle por meio de vinculação de dados.

<%@ 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>


Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: