GridViewRowEventArgs Klasse

Definition

Stellt Daten für das RowCreated-Ereignis und das RowDataBound-Ereignis bereit.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
Vererbung
GridViewRowEventArgs

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das GridViewRowEventArgs -Objekt, das an die Ereignis Behandlungsmethode übermittelt wird, verwendet wird, um auf die Eigenschaften der Zeile zuzugreifen, die an Daten gebunden wird.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>

Hinweise

Bevor das GridView -Steuerelement gerendert GridViewRow werden kann, muss für jede Zeile im-Steuerelement ein-Objekt erstellt werden.Before the GridView control can be rendered, a GridViewRow object must be created for each row in the control. Das RowCreated -Ereignis wird jedes Mal ausgelöst, wenn eine GridView Zeile im-Steuerelement erstellt wird.The RowCreated event is raised each time a row in the GridView control is created. Dies ermöglicht es Ihnen, eine Ereignis Behandlungsmethode bereitzustellen, die eine benutzerdefinierte Routine ausführt, z. b. das Hinzufügen benutzerdefinierter Inhalte zu einer Zeile, wenn dieses Ereignis auftritt.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.

Ebenso muss jede Zeile im-Steuerelement an einen Datensatz in der Datenquelle gebunden werden, bevor GridView das-Steuerelement gerendert werden kann.Similarly, each row in the control must be bound to a record in the data source before the GridView control can be rendered. Das RowDataBound -Ereignis wird ausgelöst, wenn eine Daten Zeile (die GridViewRow durch ein-Objekt dargestellt wird) an GridView Daten im-Steuerelement gebunden ist.The RowDataBound event is raised when a data row (represented by a GridViewRow object) is bound to data in the GridView control. Dies ermöglicht es Ihnen, eine Ereignis Behandlungsmethode bereitzustellen, die eine benutzerdefinierte Routine ausführt, z. b. das Ändern der Werte der an die Zeile gebundenen Daten, wenn dieses Ereignis auftritt.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.

Ein GridViewRowEventArgs -Objekt wird an die Ereignis Behandlungsmethode übermittelt, die Ihnen den Zugriff auf die Eigenschaften der Zeile ermöglicht, die das Ereignis ausgelöst hat.A GridViewRowEventArgs object is passed to the event-handling method, which allows you to access the properties of the row that raised the event. Um auf eine bestimmte Zelle in der Zeile zuzugreifen, verwenden Cells Sie die- GridViewRow Eigenschaft des-Objekts Row , das in der-Eigenschaft enthalten ist.To access a specific cell in the row, use the Cells property of the GridViewRow object contained in the Row property. Mithilfe der RowType -Eigenschaft GridViewRow des-Objekts können Sie auch bestimmen, welcher Zeilentyp (Kopfzeile, Daten Zeile usw.) erstellt wird.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.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von GridViewRowEventArgsfinden Sie im GridViewRowEventArgs -Konstruktor.For a list of initial property values for an instance of GridViewRowEventArgs, see the GridViewRowEventArgs constructor.

Konstruktoren

GridViewRowEventArgs(GridViewRow)

Initialisiert eine neue Instanz der GridViewRowEventArgs-Klasse.Initializes a new instance of the GridViewRowEventArgs class.

Eigenschaften

Row

Ruft die Zeile ab, die erstellt oder an Daten gebunden wird.Gets the row being created or data-bound.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch