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

Classe ListItemCollection

 

Uma coleção de ListItem objetos em um controle de lista. Essa classe não pode ser herdada.

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

System.Object
  System.Web.UI.WebControls.ListItemCollection

public sealed class ListItemCollection : ICollection, IEnumerable, 
	IList, IStateManager

NomeDescrição
System_CAPS_pubmethodListItemCollection()

Inicializa uma nova instância da classe ListItemCollection.

NomeDescrição
System_CAPS_pubpropertyCapacity

Obtém ou define o número máximo de itens que o ListItemCollection pode armazenar.

System_CAPS_pubpropertyCount

Obtém o número de ListItem objetos na coleção.

System_CAPS_pubpropertyIsReadOnly

Obtém um valor que indica se o ListItemCollection é somente leitura.

System_CAPS_pubpropertyIsSynchronized

Obtém um valor que indica se o acesso para o ListItemCollection é sincronizado (thread-safe).

System_CAPS_pubpropertyItem[Int32]

Obtém um ListItem no índice especificado na coleção.

System_CAPS_pubpropertySyncRoot

Obtém o objeto que pode ser usado para sincronizar o acesso a ListItemCollection.

NomeDescrição
System_CAPS_pubmethodAdd(ListItem)

Acrescenta especificado ListItem ao final da coleção.

System_CAPS_pubmethodAdd(String)

Anexa uma ListItem ao final da coleção que representa a cadeia de caracteres especificada.

System_CAPS_pubmethodAddRange(ListItem[])

Adiciona os itens em uma matriz de ListItem objetos na coleção.

System_CAPS_pubmethodClear()

Remove todos os ListItem objetos da coleção.

System_CAPS_pubmethodContains(ListItem)

Determina se a coleção contém o item especificado.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia os itens do ListItemCollection especificado System.Array, começando com o índice especificado.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (herdado de Object.)

System_CAPS_pubmethodFindByText(String)

Procura a coleção para um ListItem com um Text propriedade que é igual ao texto especificado.

System_CAPS_pubmethodFindByValue(String)

Procura a coleção para um ListItem com um Value propriedade que contém o valor especificado.

System_CAPS_pubmethodGetEnumerator()

Retorna um System.Collections.IEnumerator implementado o objeto que contém todos os ListItem objetos no ListItemCollection.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(herdado de Object.)

System_CAPS_pubmethodIndexOf(ListItem)

Determina o valor de índice que representa a posição especificada ListItem na coleção.

System_CAPS_pubmethodInsert(Int32, ListItem)

Insere especificado ListItem na coleção no local de índice especificado.

System_CAPS_pubmethodInsert(Int32, String)

Insere um ListItem que representa a cadeia de caracteres especificada na coleção no local de índice especificado.

System_CAPS_pubmethodRemove(ListItem)

Remove o ListItem da coleção.

System_CAPS_pubmethodRemove(String)

Remove um ListItem da coleção que representa a cadeia de caracteres especificada.

System_CAPS_pubmethodRemoveAt(Int32)

Remove o ListItem no índice especificado da coleção.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(herdado de Object.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte Add.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte Contains.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte IndexOf.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte Insert.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte Remove.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Carrega o estado salvo anteriormente.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Retorna o objeto que contém as alterações de estado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Inicia o estado das alterações de controle.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte IsFixedSize.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte Item.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Esta API suporta a infraestrutura produto e não é destinada a ser usada diretamente no seu código. Para obter uma descrição desse membro, consulte IsTrackingViewState.

NomeDescrição
System_CAPS_pubmethodAsParallel()

Sobrecarregado. Permite a paralelização de uma consulta. (Definido por ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sobrecarregado. Converte um IEnumerable para um IQueryable.(Definido por Queryable.)

System_CAPS_pubmethodCast<TResult>()

Converte os elementos de um IEnumerable para o tipo especificado.(Definido por Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra os elementos de um IEnumerable com base em um tipo especificado.(Definido por Enumerable.)

O ListItemCollection classe representa uma coleção de ListItem objetos. O ListItem objetos, por sua vez, representam os itens exibidos em controles de lista, como o ListBox. Para recuperar programaticamente ListItem objetos de um controle de lista, use um dos seguintes métodos:

  • Use o indexador para obter um único ListItem da coleção, usando a notação de matriz.

  • Use o CopyTo método para copiar o conteúdo da coleção para uma System.Array objeto, que pode ser usado para obter os itens da coleção.

  • Use o GetEnumerator método para criar um System.Collections.IEnumerator objeto implementado, o que pode ser usado para obter os itens da coleção.

  • Use foreach (c#) ou For Each (Visual Basic) para iterar na coleção.

O Count propriedade especifica o número total de itens na coleção e normalmente é usada para determinar o limite superior da coleção. Você pode adicionar e remover itens da coleção usando o Add e Remove métodos.

O exemplo de código a seguir demonstra como criar ListItemCollection objetos, adicionando itens das coleções e removendo itens das coleções. No exemplo, o ListItemCollection chamado listBoxData é usado como fonte de dados para um ListBox controle chamado ListBox1, e o ListItemCollection chamado ddBoxData é usado como fonte de dados para um DropDownList controle chamado DropDownList1.

<%@ Page language="C#" AutoEventWireup="true" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    private void Page_Load(object sender, System.EventArgs e)
    {
        // If this isn't the first time the page is loaded in this session,
        // then don't recreate the DataTables.
        if (!IsPostBack)
        {
            // Create a new ListItemCollection.
            ListItemCollection listBoxData = new ListItemCollection();
            // Add items to the collection.
            listBoxData.Add(new ListItem("apples"));
            listBoxData.Add(new ListItem("bananas"));
            listBoxData.Add(new ListItem("cherries"));
            listBoxData.Add("grapes");
            listBoxData.Add("mangos");
            listBoxData.Add("oranges");
            // Set the ListItemCollection as the data source for ListBox1.
            ListBox1.DataSource = listBoxData;
            ListBox1.DataBind();

            // Create a new ListItemCollection.
            ListItemCollection ddBoxData = new ListItemCollection();
            // For now, just bind the data to the DropDownList.
            DropDownList1.DataSource = ddBoxData;
            DropDownList1.DataBind();
        }        
    }

    private void moveButton1_Click(object sender, System.EventArgs e)
    {
        //Set the SelectedIndex to -1 so no items are selected.
        // The new item will be set as the selected item when it is added.
        DropDownList1.SelectedIndex = -1;
        // Add the selected item to DropDownList1.
        DropDownList1.Items.Add(ListBox1.SelectedItem);
        // Delete the selected item from ListBox1.
        ListBox1.Items.Remove(ListBox1.SelectedItem);
    }

    private void moveButton2_Click(object sender, System.EventArgs e)
    {
        //Set the SelectedIndex to -1 so no items are selected.
        // The new item will be set as the selected item when it is added.
        ListBox1.SelectedIndex = -1;
        // Add the selected item to ListBox1.
        ListBox1.Items.Add(DropDownList1.SelectedItem);
        //Delete the selected item from DropDownList1.
        DropDownList1.Items.Remove(DropDownList1.SelectedItem);
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title>ASP.NET Example</title>
</head>

    <body>
        <form id="form1" runat="server">
            <table cellpadding="6" border="0">
                <tr>
                    <td rowspan="2" valign="top">
                        <asp:ListBox id="ListBox1" runat="server" 
                            SelectionMode="Single" Width="100px">
                        </asp:ListBox>
                    </td>

                    <td>
                        <asp:Button id="moveButton1" runat="server" Text="Move -->"
                            Width="100px" OnClick="moveButton1_Click"></asp:Button>
                    </td>

                    <td rowspan="2" valign="top">
                        <asp:DropDownList Runat="server" ID="DropDownList1"
                            Width="100px">
                        </asp:DropDownList>
                    </td>
                </tr>

                <tr>
                    <td>
                        <asp:Button ID="moveButton2" Runat="server" Text="<-- Move"
                            Width="100px" onClick="moveButton2_Click"></asp:Button>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</html>
<!-- This example demonstrates how to select multiple items from a DataList and add the 
selected items to a DataGrid. The example uses a foreach loop to iterate through 
the ListItem objects in the ListItemCollection of ListBox1. -->

<%@ Page language="c#" AutoEventWireup="true"%>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script language="C#" runat="server">
            // Global Variables.
            private DataView dv;
            private DataTable dt = new DataTable();

            private void Page_Load(object sender, System.EventArgs e)
            {
                // Set the number of rows displayed in the ListBox to be
                // the number of items in the ListBoxCollection.
                ListBox1.Rows = ListBox1.Items.Count;

                // If the DataTable is already stored in the Web form's default
                // HttpSessionState variable, then don't recreate the DataTable.
                if (Session["data"] == null)
                {
                    // Add columns to the DataTable.
                    dt.Columns.Add(new DataColumn("Item"));
                    dt.Columns.Add(new DataColumn("Price"));
            // Store the DataTable in the Session variable so it can 
                    // be accessed again later.
                    Session["data"] = dt;

                    // Use the table to create a DataView, because the DataGrid
                    // can only bind to a data source that implements IEnumerable.
                    dv = new DataView(dt);

                    // Set the DataView as the data source, and bind it to the DataGrid.
                    DataGrid1.DataSource = dv;
                    DataGrid1.DataBind();
                }
            }

            private void addButton_Click(object sender, System.EventArgs e)
            {
                // Add the items selected in ListBox1 to DataGrid1.
                foreach (ListItem item in ListBox1.Items)
                {
                    if (item.Selected)
                    {
                        // Add the item to the DataGrid.
                        // First, get the DataTable from the Session variable.
                        dt = (DataTable)Session["data"];

                        if (dt != null)
                        { 
                            // Create a new DataRow in the DataTable.
                            DataRow dr = dt.NewRow();
                            // Add the item to the new DataRow.
                            dr["Item"] = item.Text;
                            // Add the item's value to the DataRow.
                            dr["Price"] = item.Value;
                            // Add the DataRow to the DataTable.
                            dt.Rows.Add(dr);

                            // Rebind the data to DataGrid1.
                            dv = new DataView(dt);
                            DataGrid1.DataSource = dv;
                            DataGrid1.DataBind();
                        }
                    }
                }
            }
        </script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title> ListItemCollection Example </title>
</head>

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

            <h3> ListItemCollection Example </h3>

            <table cellpadding="6" border="0">
                <tr>
                    <td valign="top">
                        <asp:ListBox id="ListBox1" runat="server" SelectionMode="Multiple">
                            <asp:ListItem Value=".89">apples</asp:ListItem>
                            <asp:ListItem Value=".49">bananas</asp:ListItem>
                            <asp:ListItem Value="2.99">cherries</asp:ListItem>
                            <asp:ListItem Value="1.49">grapes</asp:ListItem>
                            <asp:ListItem Value="2.00">mangos</asp:ListItem>
                            <asp:ListItem Value="1.09">oranges</asp:ListItem>
                        </asp:ListBox>
                    </td>

                    <td valign="top">
                        <asp:Button id="addButton" runat="server" Text="Add -->"
                            Width="100px" OnClick="addButton_Click"></asp:Button>
                    </td>

                    <td valign="top">
                        <asp:DataGrid Runat="server" ID="DataGrid1" CellPadding="4">
                        </asp:DataGrid>
                    </td>
                </tr>
            </table>        
        </form>
    </body>
</html>

.NET Framework
Disponível desde 1.1

Qualquer estático público (Compartilhado no Visual Basic) membros desde tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao topo
Mostrar: