GridViewRowEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce i dati per gli eventi RowCreated e RowDataBound.

public ref class GridViewRowEventArgs : EventArgs

public class GridViewRowEventArgs : EventArgs

type GridViewRowEventArgs = class
    inherit EventArgs

Public Class GridViewRowEventArgs
Inherits EventArgs

Ereditarietà: Object

EventArgs
GridViewRowEventArgs

Esempio

Nell'esempio seguente viene illustrato come utilizzare l'oggetto GridViewRowEventArgs passato al metodo di gestione degli eventi per accedere alle proprietà della riga associate ai dati.


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

Commenti

Prima di poter eseguire il rendering del GridView controllo, è necessario creare un GridViewRow oggetto per ogni riga nel controllo . L'evento RowCreated viene generato ogni volta che viene creata una riga nel GridView controllo . In questo modo è possibile fornire un metodo di gestione degli eventi che esegue una routine personalizzata, ad esempio l'aggiunta di contenuto personalizzato a una riga, ogni volta che si verifica questo evento.

Analogamente, ogni riga del controllo deve essere associata a un record nell'origine dati prima di poter eseguire il rendering del GridView controllo. L'evento RowDataBound viene generato quando una riga di dati (rappresentata da un GridViewRow oggetto ) è associata ai dati nel GridView controllo . In questo modo è possibile fornire un metodo di gestione degli eventi che esegue una routine personalizzata, ad esempio modificando i valori dei dati associati alla riga, ogni volta che si verifica questo evento.

Un GridViewRowEventArgs oggetto viene passato al metodo di gestione degli eventi, che consente di accedere alle proprietà della riga che ha generato l'evento. Per accedere a una cella specifica nella riga, utilizzare la Cells proprietà dell'oggetto GridViewRow contenuto nella Row proprietà . È anche possibile determinare il tipo di riga (riga di intestazione, riga di dati e così via) creato usando la RowType proprietà dell'oggetto GridViewRow .

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Per un elenco dei valori iniziali delle proprietà per un'istanza di GridViewRowEventArgs, vedere il GridViewRowEventArgs costruttore .

Costruttori

GridViewRowEventArgs(GridViewRow)

Inizializza una nuova istanza della classe GridViewRowEventArgs.

Proprietà

Row	Ottiene la riga da creare o da associare ai dati.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a