Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Classe GridViewRowCollection

.NET Framework 3.5

Outras versões

Representa uma coleção de objetos GridViewRow em um controle GridView.

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

Sintaxe

C++

JScript

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class GridViewRowCollection : ICollection, 
	IEnumerable

Comentários

The GridViewRowCollection classe é usada para armazenar e gerenciar uma coleção de GridViewRow objetos em um GridView controle. Cada linha em um GridView controle é representado por um GridViewRow objeto. The GridView controle armazena todas as suas linhas de dados do Rows coleção.

The GridViewRowCollection classe oferece suporte para várias maneiras de acessar os itens na coleção:

Use o Item Indexador recuperar diretamente um GridViewRow objeto em um índice específico baseado em zero.
Use o GetEnumerator método para recuperar um enumerador que pode ser usado para iterar na coleção.
Use o CopyTo método para copiar os itens na coleção em um System.Array objeto, que pode ser usado para acesso itens na coleção.

Para determinar o número total de itens na coleção, use o Count propriedade

Exemplos

O exemplo a seguir demonstra como percorrer o Rows coleção de um GridView controlar e exibir os valores de uma coluna na página.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void AuthorsGridView_RowCreated(Object sender, GridViewRowEventArgs e)
  {
    if (e.Row.RowType == DataControlRowType.Footer)
    {      

      // Get the number of items in the Rows collection.int count = AuthorsGridView.Rows.Count;

      // If the GridView control contains any records, display // the last name of each author in the GridView control.if (count > 0)
      {      
        Message.Text = "The authors are:<br />";

        foreach (GridViewRow row in AuthorsGridView.Rows)
        {
          Message.Text += row.Cells[0].Text + "<br />";
        }
      }

    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridViewRowCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridViewRowCollection Example</h3>

      <table>
        <tr>
          <td>
            <asp:gridview id="AuthorsGridView" 
              datasourceid="AuthorsSqlDataSource" 
              autogeneratecolumns="false"
              onrowcreated="AuthorsGridView_RowCreated"  
              runat="server"> 

              <columns>
                <asp:boundfield datafield="au_lname"
                  headertext="Last Name"/>
                <asp:boundfield datafield="au_fname"
                  headertext="First Name"/>
              </columns>

            </asp:gridview>
          </td>
          <td>
            <asp:label id="Message" 
              forecolor="Red"
              runat="server"/>
          </td>
        </tr>
      </table>

      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>

    </form>
  </body>
</html>

Permissões

AspNetHostingPermission
Para operar em um ambiente hospedado.Exigem valor: LinkDemandValor de permissão: Minimal.
AspNetHostingPermission
Para operar em um ambiente hospedado.Exigem valor: InheritanceDemandValor de permissão: Minimal.

Hierarquia de herança

System.Object
System.Web.UI.WebControls.GridViewRowCollection

Acesso thread-safe

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.

Plataformas

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.

Informações sobre versão