GridViewRowEventArgs Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Tillhandahåller data för RowCreated och RowDataBound händelserna.

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Arv
Object
EventArgs
GridViewRowEventArgs

Exempel

I följande exempel visas hur du använder objektet GridViewRowEventArgs som skickas till händelsehanteringsmetoden för att komma åt egenskaperna för raden som är bunden till 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>

Kommentarer

Innan kontrollen GridView kan återges måste ett GridViewRow objekt skapas för varje rad i kontrollen. Händelsen RowCreated utlöses varje gång en rad i GridView kontrollen skapas. På så sätt kan du ange en metod för händelsehantering som utför en anpassad rutin, till exempel att lägga till anpassat innehåll på en rad, när den här händelsen inträffar.

På samma sätt måste varje rad i kontrollen bindas till en post i datakällan innan GridView kontrollen kan återges. Händelsen RowDataBound utlöses när en datarad (representeras av ett GridViewRow objekt) är bunden till data i GridView kontrollen. På så sätt kan du ange en metod för händelsehantering som utför en anpassad rutin, till exempel ändra värdena för data som är bundna till raden, när den här händelsen inträffar.

Ett GridViewRowEventArgs objekt skickas till metoden för händelsehantering, vilket gör att du kan komma åt egenskaperna för den rad som skapade händelsen. Om du vill komma åt en specifik cell på raden använder du Cells egenskapen för GridViewRow objektet som finns i egenskapen Row . Du kan också avgöra vilken radtyp (rubrikrad, datarad och så vidare) som skapas med hjälp RowType av objektets GridViewRow egenskap.

Mer information om hur du hanterar händelser finns i Hantera och höja händelser.

En lista över initiala egenskapsvärden för en instans av GridViewRowEventArgsfinns i GridViewRowEventArgs konstruktorn.

Konstruktorer

Name Description
GridViewRowEventArgs(GridViewRow)

Initierar en ny instans av GridViewRowEventArgs klassen.

Egenskaper

Name Description
Row

Hämtar raden som skapas eller är databunden.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även