GridViewRowCollection Clase

Definición

Representa una colección de objetos GridViewRow de un control GridView.Represents a collection of GridViewRow objects in a GridView control.

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
Herencia
GridViewRowCollection
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo recorrer en iteración la Rows colección de un control GridView y mostrar los valores de una columna en la página.The following example demonstrates how to iterate through the Rows collection of a GridView control and display the values of a column on the page.


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

Comentarios

La clase GridViewRowCollection se utiliza para almacenar y administrar una colección de objetos GridViewRow en un control GridView.The GridViewRowCollection class is used to store and manage a collection of GridViewRow objects in a GridView control. Cada fila de un control GridView se representa mediante un objeto GridViewRow.Each row in a GridView control is represented by a GridViewRow object. El control GridView almacena todas sus filas de datos en la colección Rows.The GridView control stores all of its data rows in the Rows collection.

La clase GridViewRowCollection admite varias maneras de obtener acceso a los elementos de la colección:The GridViewRowCollection class supports several ways to access the items in the collection:

  • Use el indexador de Item[Int32] para recuperar directamente un objeto GridViewRow en un índice de base cero específico.Use the Item[Int32] indexer to directly retrieve a GridViewRow object at a specific zero-based index.

  • Utilice el método GetEnumerator para recuperar un enumerador que se puede utilizar para recorrer en iteración la colección.Use the GetEnumerator method to retrieve an enumerator that can be used to iterate through the collection.

  • Utilice el método CopyTo para copiar los elementos de la colección en un objeto System.Array, que se puede usar para tener acceso a los elementos de la colección.Use the CopyTo method to copy the items in the collection into an System.Array object, which can then be used to access the items in the collection.

Para determinar el número total de elementos de la colección, use la propiedad CountTo determine the total number of items in the collection, use the Count property

Constructores

GridViewRowCollection(ArrayList)

Inicializa una nueva instancia de la clase GridViewRowCollection utilizando el objeto ArrayList especificado.Initializes a new instance of the GridViewRowCollection class using the specified ArrayList object.

Propiedades

Count

Obtiene el número de elementos del objeto GridViewRowCollection.Gets the number of items in the GridViewRowCollection object.

IsReadOnly

Obtiene un valor que indica si pueden modificarse las filas del objeto GridViewRowCollection.Gets a value indicating whether the rows in the GridViewRowCollection object can be modified.

IsSynchronized

Obtiene un valor que indica si el objeto GridViewRowCollection está sincronizado (es seguro para la ejecución de subprocesos).Gets a value indicating whether the GridViewRowCollection object is synchronized (thread-safe).

Item[Int32]

Obtiene el objeto GridViewRow en el índice especificado.Gets the GridViewRow object at the specified index.

SyncRoot

Obtiene el objeto que se utiliza para sincronizar el acceso a la colección.Gets the object used to synchronize access to the collection.

Métodos

CopyTo(GridViewRow[], Int32)

Copia todos los elementos de la colección GridViewRowCollection en el objeto Array especificado, comenzando en el índice especificado del objeto Array.Copies all the items from this GridViewRowCollection to the specified Array object, starting at the specified index in the Array object.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Devuelve un enumerador que contiene todos los objetos GridViewRow de la colección GridViewRowCollection.Returns an enumerator that contains all GridViewRow objects in the GridViewRowCollection.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Para una descripción de este miembro, vea CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: