GridViewRowCollection Classe

Définition

Représente une collection d'objets GridViewRow dans un contrôle 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
Héritage
GridViewRowCollection
Implémente

Exemples

L’exemple suivant montre comment itérer au sein de Rows la collection d' GridView un contrôle et afficher les valeurs d’une colonne sur la page.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>

Remarques

La GridViewRowCollection classe est utilisée pour stocker et gérer une collection d' GridViewRow objets dans un GridView contrôle.The GridViewRowCollection class is used to store and manage a collection of GridViewRow objects in a GridView control. Chaque ligne d’un GridView contrôle est représentée par un GridViewRow objet.Each row in a GridView control is represented by a GridViewRow object. Le GridView contrôle stocke toutes ses lignes de données dans Rows la collection.The GridView control stores all of its data rows in the Rows collection.

La GridViewRowCollection classe prend en charge plusieurs façons d’accéder aux éléments de la collection:The GridViewRowCollection class supports several ways to access the items in the collection:

  • Utilisez l' Item[Int32] indexeur pour récupérer directement un GridViewRow objet à un index de base zéro spécifique.Use the Item[Int32] indexer to directly retrieve a GridViewRow object at a specific zero-based index.

  • Utilisez la GetEnumerator méthode pour récupérer un énumérateur qui peut être utilisé pour itérer au sein de la collection.Use the GetEnumerator method to retrieve an enumerator that can be used to iterate through the collection.

  • Utilisez la CopyTo méthode pour copier les éléments de la collection dans un System.Array objet, qui peut ensuite être utilisé pour accéder aux éléments de la collection.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.

Pour déterminer le nombre total d’éléments dans la collection, utilisez la Count propriétéTo determine the total number of items in the collection, use the Count property

Constructeurs

GridViewRowCollection(ArrayList)

Initialise une nouvelle instance de la classe GridViewRowCollection à l'aide de l'objet ArrayList spécifié.Initializes a new instance of the GridViewRowCollection class using the specified ArrayList object.

Propriétés

Count

Obtient le nombre d'éléments dans l'objet GridViewRowCollection.Gets the number of items in the GridViewRowCollection object.

IsReadOnly

Obtient une valeur indiquant si les lignes de l'objet GridViewRowCollection peuvent être modifiées.Gets a value indicating whether the rows in the GridViewRowCollection object can be modified.

IsSynchronized

Obtient une valeur indiquant si l'objet GridViewRowCollection est synchronisé (thread-safe).Gets a value indicating whether the GridViewRowCollection object is synchronized (thread-safe).

Item[Int32]

Obtient l’objet GridViewRow à l’index spécifié.Gets the GridViewRow object at the specified index.

SyncRoot

Obtient l'objet utilisé pour synchroniser l'accès à la collection.Gets the object used to synchronize access to the collection.

Méthodes

CopyTo(GridViewRow[], Int32)

Copie tous les éléments de ce GridViewRowCollection dans l'objet Array spécifié, en commençant à l'index spécifié dans l'objet Array.Copies all the items from this GridViewRowCollection to the specified Array object, starting at the specified index in the Array object.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un énumérateur qui contient tous les objets GridViewRow de GridViewRowCollection.Returns an enumerator that contains all GridViewRow objects in the GridViewRowCollection.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Pour obtenir une description de ce membre, consultez CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi