GridView.RowDataBound, événement (System.Web.UI.WebControls)

RowDataBound, événement

Réduire tout

Filtre de language

Cette page est spécifique à

Microsoft Visual Studio 2005/.NET Framework 2.0

D'autres versions sont également disponibles pour :

Bibliothèque de classes .NET Framework

GridView.RowDataBound, événement

Remarque : cet événement est nouveau dans le .NET Framework version 2.0.

Se produit lorsqu'une ligne de données est liée aux données dans un contrôle GridView.

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

Syntaxe

Visual Basic (Déclaration)

Public Event RowDataBound As GridViewRowEventHandler

Visual Basic (Utilisation)

Dim instance As GridView
Dim handler As GridViewRowEventHandler

AddHandler instance.RowDataBound, handler

public event GridViewRowEventHandler RowDataBound

C++

public:
event GridViewRowEventHandler^ RowDataBound {
    void add (GridViewRowEventHandler^ value);
    void remove (GridViewRowEventHandler^ value);
}

/** @event */
public void add_RowDataBound (GridViewRowEventHandler value)

/** @event */
public void remove_RowDataBound (GridViewRowEventHandler value)

JScript

JScript prend en charge l'utilisation d'événements mais pas la déclaration de nouveaux événements.

Notes

Avant que le contrôle GridView ne puisse être restitué, chaque ligne du contrôle doit être liée à un enregistrement dans la source de données. 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 liée. Pour accéder à une cellule spécifique de la ligne, utilisez la propriété Cells de l'objet GridViewRowEventArgs. Vous pouvez déterminer le type de ligne (ligne d'en-tête, ligne de données, etc.) créé en utilisant la propriété RowType.

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

Topic	Location
Comment : définir dynamiquement la largeur de colonne d'un contrôle serveur Web GridView	Génération d'applications Web ASP.NET
Comment : définir dynamiquement la largeur de colonne d'un contrôle serveur Web GridView	Génération d'applications Web ASP.NET dans Visual Studio

Exemple

L'exemple de code suivant montre comment utiliser l'événement RowDataBound pour modifier la valeur d'un champ de la source de données avant qu'elle ne soit affichée dans un contrôle GridView.

Visual Basic

<%@ Page language="VB" %>

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

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

Plates-formes

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.

Informations de version

.NET Framework

Prise en charge dans : 2.0

Voir aussi

Référence

GridView, classe
Membres GridView
System.Web.UI.WebControls, espace de noms
GridViewRowEventArgs
OnRowDataBound
GridView.RowCreated, événement
OnRowCreated

Autres ressources

Consommation d'événements

Mots clés

: Ajouter un mot clé

Contenu de la communauté

Ajouter du contenu

Annotations

Gérer votre profil | Contactez-nous | Newsletter MSDN