GridViewRowEventArgs Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Udostępnia dane dla zdarzeń RowCreated i RowDataBound .

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

Przykłady

W poniższym przykładzie pokazano, jak używać GridViewRowEventArgs obiektu przekazanego do metody obsługi zdarzeń w celu uzyskania dostępu do właściwości wiersza powiązanego z danymi.


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

Uwagi

Przed renderowaniem GridViewRow kontrolki GridView należy utworzyć obiekt dla każdego wiersza w kontrolce. Zdarzenie RowCreated jest wywoływane za każdym razem, gdy zostanie utworzony wiersz w kontrolce GridView . Dzięki temu można podać metodę obsługi zdarzeń, która wykonuje niestandardową procedurę, taką jak dodawanie niestandardowej zawartości do wiersza, za każdym razem, gdy wystąpi to zdarzenie.

Podobnie każdy wiersz w kontrolce musi być powiązany z rekordem w źródle danych przed renderowaniem kontrolki GridView . Zdarzenie RowDataBound jest wywoływane, gdy wiersz danych (reprezentowany przez GridViewRow obiekt) jest powiązany z danymi w kontrolce GridView . Dzięki temu można podać metodę obsługi zdarzeń, która wykonuje niestandardową procedurę, taką jak modyfikowanie wartości danych powiązanych z wierszem, za każdym razem, gdy wystąpi to zdarzenie.

GridViewRowEventArgs Obiekt jest przekazywany do metody obsługi zdarzeń, która umożliwia dostęp do właściwości wiersza, który wzbudził zdarzenie. Aby uzyskać dostęp do określonej komórki w wierszu, użyj Cells właściwości GridViewRow obiektu zawartego Row we właściwości . Można również określić, który typ wiersza (wiersz nagłówka, wiersz danych itd.) jest tworzony przy użyciu RowType właściwości GridViewRow obiektu.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia programu GridViewRowEventArgs, zobacz GridViewRowEventArgs konstruktor.

Konstruktory

GridViewRowEventArgs(GridViewRow)

Inicjuje nowe wystąpienie klasy GridViewRowEventArgs.

Właściwości

Row

Pobiera tworzony wiersz lub powiązany z danymi.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też