GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs Class

Definizione

Fornisce i dati per gli eventi RowCreated e RowDataBound.Provides data for the RowCreated and RowDataBound events.

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Ereditarietà
GridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgs

Esempi

Nell'esempio seguente viene illustrato come utilizzare l' GridViewRowEventArgs oggetto passato al metodo di gestione degli eventi per accedere alle proprietà della riga da associare ai dati.The following example demonstrates how to use the GridViewRowEventArgs object passed to the event-handling method to access the properties of the row being bound to data.


<%@ 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 GridView poter eseguire il rendering del controllo GridViewRow , è necessario creare un oggetto per ogni riga nel controllo.Before the GridView control can be rendered, a GridViewRow object must be created for each row in the control. L' RowCreated evento viene generato ogni volta che viene creata una GridView riga nel controllo.The RowCreated event is raised each time a row in the GridView control is created. Questo consente di 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.This allows you to provide an event-handling method that performs a custom routine, such as adding custom content to a row, whenever this event occurs.

Analogamente, ogni riga nel controllo deve essere associata a un record nell'origine dati prima di poter GridView eseguire il rendering del controllo.Similarly, each row in the control must be bound to a record in the data source before the GridView control can be rendered. L' RowDataBound evento viene generato quando una riga di dati (rappresentata GridViewRow da un oggetto) viene GridView associata ai dati nel controllo.The RowDataBound event is raised when a data row (represented by a GridViewRow object) is bound to data in the GridView control. Questo consente di fornire un metodo di gestione degli eventi che esegue una routine personalizzata, ad esempio la modifica dei valori associati alla riga, ogni volta che si verifica questo evento.This allows you to provide an event-handling method that performs a custom routine, such as modifying the values of the data bound to the row, whenever this event occurs.

Un GridViewRowEventArgs oggetto viene passato al metodo di gestione degli eventi, che consente di accedere alle proprietà della riga che ha generato l'evento.A GridViewRowEventArgs object is passed to the event-handling method, which allows you to access the properties of the row that raised the event. Per accedere a una cella specifica nella riga, utilizzare la Cells proprietà GridViewRow dell'oggetto contenuto nella Row proprietà.To access a specific cell in the row, use the Cells property of the GridViewRow object contained in the Row property. È inoltre possibile determinare il tipo di riga (riga di intestazione, riga di dati e così via) da creare utilizzando la RowType proprietà GridViewRow dell'oggetto.You can also determine which row type (header row, data row, and so on) is being created by using the RowType property of the GridViewRow object.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.For more information about how to handle events, see Handling and Raising Events.

Per un elenco dei valori iniziali delle proprietà di un'istanza GridViewRowEventArgsdi, vedere GridViewRowEventArgs il costruttore.For a list of initial property values for an instance of GridViewRowEventArgs, see the GridViewRowEventArgs constructor.

Costruttori

GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow)

Inizializza una nuova istanza della classe GridViewRowEventArgs.Initializes a new instance of the GridViewRowEventArgs class.

Proprietà

Row Row Row Row

Ottiene la riga da creare o da associare ai dati.Gets the row being created or data-bound.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche