GridViewRowEventArgs Classe

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Héritage
Object
EventArgs
GridViewRowEventArgs

Exemples

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


<%@ 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 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowDataBound Example</title>
</head>
<body>
    <form id="form1" 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>


<%@ 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 CustomersGridView_RowDataBound(ByVal sender As Object, ByVal e As GridViewRowEventArgs)

    If e.Row.RowType = DataControlRowType.DataRow Then
    
      ' Display the company name in italics.
      e.Row.Cells(1).Text = "<i>" & e.Row.Cells(1).Text & "</i>"
        
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowDataBound Example</title>
</head>
<body>
    <form id="form1" 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>

Remarques

Avant que le GridView contrôle puisse être rendu, un GridViewRow objet doit être créé pour chaque ligne du contrôle. L’événement RowCreated est déclenché chaque fois qu’une ligne dans le GridView contrôle est créée. Cela vous permet de fournir une méthode de gestion des événements qui effectue une routine personnalisée, telle que l’ajout de 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 pour que le GridView contrôle puisse être rendu. L’événement RowDataBound est déclenché lorsqu’une ligne de données (représentée par un GridViewRow objet) est liée aux données du GridView contrôle. Cela vous permet de fournir une méthode de gestion des événements qui effectue une routine personnalisée, telle que la modification des valeurs des données liées à la ligne, chaque fois que cet événement se produit.

Un GridViewRowEventArgs objet est passé à la méthode de gestion des é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 Cells propriété de l’objet GridViewRow contenu dans la Row propriété . Vous pouvez également déterminer quel type de ligne (ligne d’en-tête, ligne de données, etc.) est créé à l’aide de la RowType propriété de l’objet GridViewRow .

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

Pour obtenir la liste des valeurs de propriété initiales d’un instance de GridViewRowEventArgs, consultez le GridViewRowEventArgs constructeur .

Constructeurs

GridViewRowEventArgs(GridViewRow)

Initialise une nouvelle instance de la classe GridViewRowEventArgs.

Propriétés

Row

Obtient la ligne qui va être créée ou liée aux données.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi