GridViewRowEventArgs Třída

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Poskytuje data pro RowCreated události a RowDataBound .

public ref class GridViewRowEventArgs : EventArgs
public class GridViewRowEventArgs : EventArgs
type GridViewRowEventArgs = class
    inherit EventArgs
Public Class GridViewRowEventArgs
Inherits EventArgs
Dědičnost
Object
EventArgs
GridViewRowEventArgs

Příklady

Následující příklad ukazuje, jak použít GridViewRowEventArgs objekt předaný do metody zpracování událostí pro přístup k vlastnostem řádku vázaného na 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>

Poznámky

Před vykreslení GridView ovládacího prvku musí být pro každý řádek v ovládacím GridViewRow prvku vytvořen objekt. Událost RowCreated je vyvolána při každém vytvoření řádku v ovládacím GridView prvku. To vám umožní poskytnout metodu zpracování událostí, která provádí vlastní rutinu, například přidání vlastního obsahu do řádku, kdykoli dojde k této události.

Podobně každý řádek v ovládacím prvku musí být vázán na záznam ve zdroji dat, aby GridView bylo možné ovládací prvek vykreslit. Událost RowDataBound je vyvolána, když je řádek dat (reprezentovaný objektem GridViewRow ) svázán s daty v ovládacím GridView prvku. To vám umožní poskytnout metodu zpracování událostí, která provádí vlastní rutinu, například úpravu hodnot dat vázaných na řádek, kdykoli dojde k této události.

Objekt GridViewRowEventArgs je předán metodě zpracování událostí, která umožňuje přístup k vlastnostem řádku, který vyvolal událost. Chcete-li získat přístup ke konkrétní buňce v řádku, použijte Cells vlastnost objektu GridViewRow obsažená Row ve vlastnosti. Pomocí vlastnosti GridViewRow objektu můžete také určit, který typ řádku (řádek záhlaví, datový řádek atd.) se vytváříRowType.

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Seznam počátečních hodnot vlastností pro instanci GridViewRowEventArgsnástroje najdete v konstruktoru GridViewRowEventArgs .

Konstruktory

GridViewRowEventArgs(GridViewRow)

Inicializuje novou instanci GridViewRowEventArgs třídy.

Vlastnosti

Row

Získá řádek, který je vytvořen nebo vázán na data.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také