GridViewRowCollection Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma coleção de GridViewRow objetos num GridView controlo.

public ref class GridViewRowCollection : System::Collections::ICollection

public class GridViewRowCollection : System.Collections.ICollection

type GridViewRowCollection = class
    interface ICollection
    interface IEnumerable

Public Class GridViewRowCollection
Implements ICollection

Herança: Object
GridViewRowCollection

Implementações: ICollection IEnumerable

Exemplos

O exemplo seguinte demonstra como iterar pela Rows coleção de um GridView controlo e mostrar 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>


<%@ Page language="VB" %>

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

  Sub AuthorsGridView_RowCreated(ByVal sender As Object, ByVal e As GridViewRowEventArgs)

    If e.Row.RowType = DataControlRowType.Footer Then
      
      ' Get the number of items in the Rows collection.
      Dim count As Integer = AuthorsGridView.Rows.Count

      ' If the GridView control contains any records, display 
      ' the last name of each author in the GridView control.
      If count > 0 Then
           
        Message.Text = "The authors are:<br />"
        
        Dim row As GridViewRow
        For Each row In AuthorsGridView.Rows
        
          Message.Text &= row.Cells(0).Text & "<br />"
        
        Next
        
      End If
        
    End If
        
  End Sub

</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>

Observações

A GridViewRowCollection classe é usada para armazenar e gerir uma coleção de GridViewRow objetos num GridView controlo. Cada linha num GridView controlo é representada por um GridViewRow objeto. O GridView controlo armazena todas as suas linhas de dados na Rows coleção.

A GridViewRowCollection classe suporta várias formas de aceder aos itens da coleção:

Use o Item[] indexador para recuperar diretamente um GridViewRow objeto num índice específico baseado em zero.
Use o GetEnumerator método para recuperar um enumerador que pode ser usado para iterar pela coleção.
Use o CopyTo método para copiar os itens da coleção para um System.Array objeto, que pode depois ser usado para aceder aos itens da coleção.

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

Construtores

Name	Description
GridViewRowCollection(ArrayList)	Inicializa uma nova instância da GridViewRowCollection classe usando o objeto especificado ArrayList .

Propriedades

Name	Description
Count	Obtém o número de itens no GridViewRowCollection objeto.
IsReadOnly	Recebe um valor que indica se as linhas do GridViewRowCollection objeto podem ser modificadas.
IsSynchronized	Recebe um valor que indica se o GridViewRowCollection objeto está sincronizado (thread-safe).
Item[Int32]	Obtém o GridViewRow objeto no índice especificado.
SyncRoot	Obtém o objeto usado para sincronizar o acesso à coleção.

Métodos

Name	Description
CopyTo(GridViewRow[], Int32)	Copia todos os itens deste GridViewRowCollection para o objeto especificado Array , começando no índice especificado no Array objeto.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Devolve um enumerador que contém todos GridViewRow os objetos no GridViewRowCollection.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Implementações de Interface Explícita

Name	Description
ICollection.CopyTo(Array, Int32)	Para uma descrição deste elemento, veja CopyTo(Array, Int32).

Métodos da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?