GridViewRowEventArgs Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Daten für das RowCreated-Ereignis und das RowDataBound-Ereignis bereit.

public ref class GridViewRowEventArgs : EventArgs

public class GridViewRowEventArgs : EventArgs

type GridViewRowEventArgs = class
    inherit EventArgs

Public Class GridViewRowEventArgs
Inherits EventArgs

Vererbung: Object

EventArgs
GridViewRowEventArgs

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das an die GridViewRowEventArgs Ereignisbehandlungsmethode übergebene -Objekt verwendet wird, um auf die Eigenschaften der Zeile zuzugreifen, die an Daten gebunden ist.


<%@ 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 werden kann, muss für jede Zeile im Steuerelement ein GridViewRow -Objekt erstellt werden. Das RowCreated -Ereignis wird jedes Mal ausgelöst, wenn eine Zeile im GridView Steuerelement erstellt wird. Dadurch können Sie eine Ereignisbehandlungsmethode bereitstellen, die eine benutzerdefinierte Routine ausführt, z. B. das Hinzufügen benutzerdefinierter Inhalte zu einer Zeile, wenn dieses Ereignis auftritt.

Ebenso muss jede Zeile im Steuerelement an einen Datensatz in der Datenquelle gebunden sein, bevor das GridView Steuerelement gerendert werden kann. Das RowDataBound -Ereignis wird ausgelöst, wenn eine Datenzeile (dargestellt durch ein GridViewRow -Objekt) an Daten im GridView Steuerelement gebunden ist. Dadurch können Sie eine Ereignisbehandlungsmethode bereitstellen, die eine benutzerdefinierte Routine ausführt, z. B. das Ändern der Werte der an die Zeile gebundenen Daten, wenn dieses Ereignis eintritt.

Ein GridViewRowEventArgs -Objekt wird an die Ereignisbehandlungsmethode übergeben, mit der Sie auf die Eigenschaften der Zeile zugreifen können, die das Ereignis ausgelöst hat. Um auf eine bestimmte Zelle in der Zeile zuzugreifen, verwenden Sie die Cells -Eigenschaft des -Objekts, das GridViewRow in der Row -Eigenschaft enthalten ist. Sie können auch bestimmen, welcher Zeilentyp (Kopfzeile, Datenzeile usw.) erstellt wird, indem Sie die RowType -Eigenschaft des GridViewRow -Objekts verwenden.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Eine Liste der anfänglichen Eigenschaftswerte für eine instance von GridViewRowEventArgsfinden Sie im GridViewRowEventArgs Konstruktor.

Konstruktoren

GridViewRowEventArgs(GridViewRow)

Initialisiert eine neue Instanz der GridViewRowEventArgs-Klasse.

Eigenschaften

Row	Ruft die Zeile ab, die erstellt oder an Daten gebunden wird.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: