GridViewRowEventArgsとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GridViewRowEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

RowCreated イベントと RowDataBound イベントのデータを提供します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class GridViewRowEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As GridViewRowEventArgs

public class GridViewRowEventArgs : EventArgs

C++

public ref class GridViewRowEventArgs : public
 EventArgs

public class GridViewRowEventArgs extends EventArgs

JScript

public class GridViewRowEventArgs extends
 EventArgs

解説

GridView コントロールの表示前に、コントロールの各行の GridViewRow オブジェクトを作成する必要があります。RowCreated イベントは、GridView コントロールに行が作成されるたびに発生します。これにより、このイベントが発生するたびにカスタムルーチン (行へのカスタムコンテンツの追加など) を実行するイベント処理メソッドを提供できます。

同様に、コントロールの各行は、GridView コントロールの表示前にデータソースのレコードにバインドする必要があります。RowDataBound イベントは、(GridViewRow オブジェクトによって表される) データ行が GridView コントロールのデータにバインドされたときに発生します。これにより、このイベントが発生するたびにカスタムルーチン (行にバインドされたデータの値を変更するなど) を実行するイベント処理メソッドを提供できます。

GridViewRowEventArgs オブジェクトがイベント処理メソッドに渡されることにより、イベントを発生させた行のプロパティにアクセスできます。行の特定のセルにアクセスするには、Row プロパティに格納されている GridViewRow オブジェクトの Cells プロパティを使用します。GridViewRow オブジェクトの RowType プロパティを使用して、作成される行の種類 (ヘッダー行、データ行など) を確認できます。

イベント処理の詳細については、「イベントの利用」を参照してください。

GridViewRowEventArgs のインスタンスの初期プロパティ値の一覧については、GridViewSelectEventArgs コンストラクタのトピックを参照してください。

使用例

イベント処理メソッドに渡された GridViewRowEventArgs オブジェクトを使用して、データにバインドされる行のプロパティにアクセスする方法を次の例に示します。

Visual Basic

<%@ Page language="VB" %>

<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>
  <body>
    <form 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="C#" %>

<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>
  <body>
    <form 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>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
System.EventArgs
System.Web.UI.WebControls.GridViewRowEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridViewRowEventArgs メンバ
System.Web.UI.WebControls 名前空間
GridView クラス
GridViewRowEventHandler
GridView.RowCreated イベント
GridView.RowDataBound イベント
その他の技術情報
イベントの利用

GridViewRowEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

GridViewRowEventArgs クラスの新しいインスタンスを初期化します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    row As GridViewRow _
)

Visual Basic (使用法)

Dim row As GridViewRow

Dim instance As New GridViewRowEventArgs(row)

public GridViewRowEventArgs (
    GridViewRow row
)

C++

public:
GridViewRowEventArgs (
    GridViewRow^ row
)

public GridViewRowEventArgs (
    GridViewRow row
)

JScript

public function GridViewRowEventArgs (
    row : GridViewRow
)

パラメータ

row: 作成される行またはデータにバインドされる行を表す GridViewRow オブジェクト。

解説

このコンストラクタを使用して、GridViewRowEventArgs クラスの新しいインスタンスを初期化します。

GridViewRowEventArgs のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Row	row パラメータに格納された GridViewRow オブジェクト。

メモ
このコンストラクタは、主にコントロールの開発者がイベントを発生させる場合に使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridViewRowEventArgs クラス
GridViewRowEventArgs メンバ
System.Web.UI.WebControls 名前空間
Row

GridViewRowEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Row	作成される行またはデータにバインドされる行を取得します。

参照

その他の技術情報

イベントの利用

GridViewRowEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

イベントの利用

GridViewRowEventArgs メンバ

RowCreated イベントと RowDataBound イベントのデータを提供します。

GridViewRowEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	GridViewRowEventArgs	GridViewRowEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	Row	作成される行またはデータにバインドされる行を取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)