Exporter (0) Imprimer
Développer tout

GridViewRowCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une collection d'objets GridViewRow dans un contrôle GridView.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class GridViewRowCollection : ICollection, IEnumerable
public class GridViewRowCollection implements ICollection, IEnumerable
public class GridViewRowCollection implements ICollection, IEnumerable

La classe GridViewRowCollection est utilisée pour stocker et gérer une collection d'objets GridViewRow dans un contrôle GridView. Chaque ligne d'un contrôle GridView est représentée par un objet GridViewRow. Le contrôle GridView stocke toutes ses lignes de données dans la collection Rows.

La classe GridViewRowCollection prend en charge plusieurs manières d'accéder aux éléments de la collection :

  • Utilisez l'indexeur Item pour récupérer directement un objet GridViewRow à un index de base zéro spécifique.

  • Utilisez la méthode GetEnumerator afin de récupérer un énumérateur pouvant être utilisé pour parcourir la collection.

  • Utilisez la méthode CopyTo pour copier les éléments de la collection dans un objet System.Array, qui peut ensuite être utilisé pour accéder aux éléments de la collection.

Utilisez la propriété Count pour déterminer le nombre total d'éléments de la collection.

L'exemple suivant montre comment parcourir la collection Rows d'un contrôle GridView et afficher les valeurs d'une colonne sur la page.


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

<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>
  <body>
    <form 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>


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

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft