GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs GridViewRowEventArgs Class

定義

RowCreated イベントおよび RowDataBound イベントのデータを提供します。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
継承
GridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgsGridViewRowEventArgs

次の例では、使用する方法、GridViewRowEventArgsオブジェクトのデータにバインドされている行のプロパティにアクセスするイベント処理メソッドに渡されます。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>

注釈

前に、GridViewコントロールを表示できる、GridViewRowコントロールの各行に対してオブジェクトを作成する必要があります。Before the GridView control can be rendered, a GridViewRow object must be created for each row in the control. RowCreatedたびに行をイベントは、GridViewコントロールが作成されます。The RowCreated event is raised each time a row in the GridView control is created. これにより、このイベントが発生するたびに、カスタム コンテンツを行を追加するなど、カスタムのルーチンを実行するイベント処理メソッドを提供できます。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.

同様に、コントロール内の各行をする前に、データ ソース内のレコードにバインドする必要があります、GridViewコントロールを表示できます。Similarly, each row in the control must be bound to a record in the data source before the GridView control can be rendered. RowDataBoundデータ行のときにイベントが発生します (によって表される、GridViewRowオブジェクト) データには、バインド、GridViewコントロール。The RowDataBound event is raised when a data row (represented by a GridViewRow object) is bound to data in the GridView control. これにより、このイベントが発生するたびに、行にバインドされたデータの値を変更するなど、カスタムのルーチンを実行するイベント処理メソッドを提供できます。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.

AGridViewRowEventArgsオブジェクトがイベントを発生させた行のプロパティにアクセスすることができるイベント処理メソッドに渡されます。A GridViewRowEventArgs object is passed to the event-handling method, which allows you to access the properties of the row that raised the event. 行の特定のセルにアクセスするには、使用、Cellsのプロパティ、GridViewRowオブジェクトに含まれている、Rowプロパティ。To access a specific cell in the row, use the Cells property of the GridViewRow object contained in the Row property. 使用して作成されているどの行の種類 (ヘッダー行やデータの行) を確認することも、RowTypeのプロパティ、GridViewRowオブジェクト。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.

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。For more information about how to handle events, see Handling and Raising Events.

インスタンスの初期プロパティ値の一覧についてはGridViewRowEventArgsを参照してください、GridViewRowEventArgsコンス トラクター。For a list of initial property values for an instance of GridViewRowEventArgs, see the GridViewRowEventArgs constructor.

コンストラクター

GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow) GridViewRowEventArgs(GridViewRow)

GridViewRowEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the GridViewRowEventArgs class.

プロパティ

Row Row Row Row

作成される行またはデータにバインドされる行を取得します。Gets the row being created or data-bound.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください