Como: conjunto a seleção em controles de lista do servidor Web

As informações contidas neste tópico se aplicam para esses controles de servidor Web:

• ListBox

• DropDownList

• CheckBoxList

• RadioButtonList

Normalmente, os usuários selecionam itens em um controle de lista do servidor Web para indicar sua escolha.No entanto, convém pré-selecionar itens ou selecionar itens em tempo de execução (através de programação) com base em alguma condição.

Para definir a seleção em um controle de lista do servidor Web em tempo de projeto

1. Na janela Properties, clique no botão reticências () para a propriedade Items abrir a caixa de diálogo ListItem Collection Editor.

2. Na lista Members, escolha o membro a ser selecionado e, em seguida, defina sua propriedade Selected como true.

3. Se o controle estiver configurado para permitir várias seleções, repita a etapa 2 para cada item a ser selecionado e clique OK para fechar a caixa de diálogo.

Para definir uma única seleção em um controle de lista do servidor Web através de programação

• Siga um destes procedimentos:

  • Defina a propriedade SelectedIndex do controle com o valor do índice do item a ser selecionado.O índice é baseado em zero.Para não definir nenhuma seleção, defina SelectedIndex para -1.

    Observação:
    Se você definir a propriedade SelectedIndex de um DropDownList como -1, o controle redefine o valor como 0, porque o controle DropDownList sempre tem um item da lista selecionado.

    ' Selects the third item
    ListBox1.SelectedIndex = 2
    

    // Selects the third item
    ListBox1.SelectedIndex = 2;
    

  • Defina a propriedade Selected de um item individual na lista.

    ' Selects the item whose text is Apples
    ListBox1.Items.FindByText("Apples")
    If Not li Is Nothing Then
       li.Selected = True
    End If
    
    // Selects the item whose text is Apples
    ListItem li = ListBox1.Items.FindByText("Apples");
    if(li != null)
    {
       li.Selected = true;
    }
    

Para definir várias seleções em um controle de lista através de programação

• Execute um loop através da coleção Items do controle e teste a propriedade Selected de cada item individual.

  Observação:
  Você só pode selecionar vários itens se a propriedade SelectionMode do controle estiver definida como Multiple.

  O exemplo a seguir mostra como você pode definir seleções em um controle ListBox denominado ListBox1.O código seleciona item sim, item não.

  Protected Sub Button1_Click(ByVal sender As System.Object, _
           ByVal e As System.EventArgs) Handles Button1.Click
     Dim i As Integer
     Dim li As ListItem
     For Each li In ListBox1.Items
        i += 1
        If (i Mod 2 = 0) Then
           li.Selected = True
        End If
     Next
  End Sub
  

  Protected void Button1_Click(object sender, System.EventArgs e)
  {
     // Counter
     int i = 0;
     foreach(ListItem li in ListBox1.Items)
     {
        if( (i%2) == 0)
        {
           li.Selected = true; 
        }
        i += 1;
     }
  }
  

Consulte também

Tarefas

Como: conjunto a seleção em controles de lista do servidor Web

Como: popular a lista servidor Web controles a partir de fontes de dados