Exporter (0) Imprimer
Développer tout

GridViewRowEventArgs, classe

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

Fournit des données pour les événements RowCreated et RowDataBound.

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

public class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs extends EventArgs
public class GridViewRowEventArgs extends EventArgs

Avant que le contrôle GridView ne puisse être rendu, un objet GridViewRow doit être créé pour chaque ligne du contrôle. L'événement RowCreated est déclenché chaque fois qu'une ligne figurant dans le contrôle GridView est créée. Cela vous permet de fournir une méthode de gestion d'événements qui exécute une routine personnalisée, par exemple l'ajout d'un contenu personnalisé à une ligne, chaque fois que cet événement se produit.

De même, chaque ligne du contrôle doit être liée à un enregistrement dans la source de données avant que le contrôle GridView ne puisse être rendu. L'événement RowDataBound est déclenché lorsqu'une ligne de données (représentée par un objet GridViewRow) est liée aux données du contrôle GridView. Cela vous permet de fournir une méthode de gestion d'événements qui exécute une routine personnalisée, par exemple la modification des données liées à la ligne, chaque fois que cet événement se produit.

Un objet GridViewRowEventArgs est passé à la méthode de gestion d'événements qui vous permet d'accéder aux propriétés de la ligne qui a déclenché l'événement. Pour accéder à une cellule spécifique de la ligne, utilisez la propriété Cells de l'objet GridViewRow contenu dans la propriété Row. Vous pouvez également déterminer le type de ligne (ligne d'en-tête, ligne de données, etc.) créé en utilisant la propriété RowType de l'objet GridViewRow.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

Pour obtenir la liste des valeurs de propriétés initiales d'une instance de GridViewRowEventArgs, consultez le constructeur GridViewSelectEventArgs.

L'exemple suivant montre comment utiliser l'objet GridViewRowEventArgs passé à la méthode de gestion d'événements pour accéder aux propriétés de la ligne qui va être liée aux données.


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

<script runat="server">

  void CustomersGridView_RowDataBound(Object sender, GridViewRowEventArgs e)
  {
        
    if(e.Row.RowType == DataControlRowType.DataRow)
    {
      // Display the company name in italics.
      e.Row.Cells[1].Text = "<i>" + e.Row.Cells[1].Text + "</i>";
        
    }
    
  }

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView RowDataBound Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        allowpaging="true"
        onrowdatabound="CustomersGridView_RowDataBound" 
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
            
    </form>
  </body>
</html>


  • AspNetHostingPermission  Pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  Pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
    System.Web.UI.WebControls.GridViewRowEventArgs

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:
© 2015 Microsoft