GridView.RowCommand イベントとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

GridView.RowCommand イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

GridView コントロールのボタンがクリックされたときに発生します。

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

Visual Basic (宣言)

Public Event RowCommand As
 GridViewCommandEventHandler

Visual Basic (使用法)

Dim instance As GridView
Dim handler As GridViewCommandEventHandler

AddHandler instance.RowCommand, handler

public event GridViewCommandEventHandler RowCommand

C++

public:
event GridViewCommandEventHandler^ RowCommand {
    void add (GridViewCommandEventHandler^ value);
    void remove (GridViewCommandEventHandler^ value);
}

/** @event */
public void add_RowCommand (GridViewCommandEventHandler
 value)

/** @event */
public void remove_RowCommand (GridViewCommandEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

RowCommand イベントは、GridView コントロールのボタンがクリックされたときに発生します。これにより、このイベントが発生するたびにカスタムルーチンを実行するイベント処理メソッドを提供できます。

GridView コントロール内のボタンから、コントロールの組み込み機能の一部を呼び出すこともできます。これらのいずれかの操作を実行するには、ボタンの CommandName プロパティを次の表の値のいずれかに設定します。

CommandName 値	説明
"Cancel"	編集操作をキャンセルし、GridView コントロールを読み取り専用モードに戻します。RowCancelingEdit イベントを発生させます。
"Delete"	現在のレコードを削除します。RowDeleting イベントおよび RowDeleted イベントを発生させます。
"Edit"	現在のレコードを編集モードにします。RowEditing イベントを発生させます。
"Page"	ページング操作を実行します。ボタンの CommandArgument プロパティを "First"、"Last"、"Next"、"Prev"、またはページ番号に設定して、実行するページング操作の種類を指定します。PageIndexChanging イベントおよび PageIndexChanged イベントを発生させます。
"Select"	現在のレコードを選択します。SelectedIndexChanging イベントおよび SelectedIndexChanged イベントを発生させます。
"Sort"	GridView コントロールを並べ替えます。Sorting イベントおよび Sorted イベントを発生させます。
"Update"	データソースの現在のレコードを更新します。RowUpdating イベントおよび RowUpdated イベントを発生させます。

前述の表に示されているボタンがクリックされると RowCommand イベントが発生しますが、表に示されているイベントを使用して操作を行うことをお勧めします。

GridViewCommandEventArgs オブジェクトがイベント処理メソッドに渡されることにより、クリックされたボタンのコマンド名およびコマンド引数を確認できます。

メモ
GridViewCommandEventArgs クラスには、どの行のボタンがクリックされたのかを示すプロパティはありません。イベントの発生元の行についての情報が必要な場合は、CommandArgument プロパティを使用して、行のインデックスをイベント処理メソッドに渡します。

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

使用例

RowCommand イベントを使用して、行の Add ボタンがクリックされたときに GridView コントロールから ListBox コントロールに顧客の名前を追加する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CustomersGridView_RowCommand(ByVal sender
 As Object, ByVal e As
 GridViewCommandEventArgs)

    ' If multiple buttons are used in a GridView control, use the
    ' CommandName property to determine which button was clicked.
    If e.CommandName = "Add" Then
    
      ' Convert the row index stored in the CommandArgument
      ' property to an Integer.
      Dim index As Integer
 = Convert.ToInt32(e.CommandArgument)
            
      ' Retrieve the row that contains the button clicked 
      ' by the user from the Rows collection.
      Dim row As GridViewRow = CustomersGridView.Rows(index)
            
      ' Create a new ListItem object for the customer in the row.  
   
      Dim item As New ListItem()
      item.Text = Server.HtmlDecode(row.Cells(2).Text)
            
      ' If the customer is not already in the ListBox, add the ListItem
 
      ' object to the Items collection of the ListBox control. 
      If Not CustomersListBox.Items.Contains(item)
 Then
      
        CustomersListBox.Items.Add(item)
        
      End If
      
    End If
    
  End Sub

  Sub CustomersGridView_RowCreated(ByVal sender
 As Object, ByVal e As
 GridViewRowEventArgs)
    
    ' The GridViewCommandEventArgs class does not contain a 
    ' property that indicates which row's command button was
    ' clicked. To identify which row's button was clicked, use 
    ' the button's CommandArgument property by setting it to the 
    ' row's index.
    If e.Row.RowType = DataControlRowType.DataRow Then
    
      ' Retrieve the LinkButton control from the first column.
      Dim addButton As LinkButton = CType(e.Row.Cells(0).Controls(0),
 LinkButton)
          
      ' Set the LinkButton's CommandArgument property with the
      ' row's index.
      addButton.CommandArgument = e.Row.RowIndex.ToString()
      
    End If

  End Sub
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView RowCommand Example</h3>
            
      <table width="100%">         
        <tr>                
          <td width="50%">
                    
            <asp:gridview id="CustomersGridView"
 
              datasourceid="CustomersSource"
              allowpaging="true" 
              autogeneratecolumns="false"
              onrowcommand="CustomersGridView_RowCommand"
              onrowcreated="CustomersGridView_RowCreated"
  
              runat="server">
                
              <columns>
                <asp:buttonfield buttontype="Link"
 
                  commandname="Add" 
                  text="Add"/>
                <asp:boundfield datafield="CustomerID"
 
                  headertext="Customer ID"/>
                <asp:boundfield datafield="CompanyName"
 
                  headertext="Company Name"/> 
                <asp:boundfield datafield="City"
 
                  headertext="City"/>         
              </columns>
                
            </asp:gridview>
                    
          </td>
                    
          <td valign="top" width="50%">
                    
            Customers: <br/>
            <asp:listbox id="CustomersListBox"
              runat="server"/> 
                    
          </td>  
        </tr>      
      </table>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [City]
 From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

<%@ Page language="C#" %>

<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs
 e)
  {
    // If multiple buttons are used in a GridView control, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Add")
    {
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);
            
      // Retrieve the row that contains the button clicked 
      // by the user from the Rows collection.
      GridViewRow row = CustomersGridView.Rows[index];
            
      // Create a new ListItem object for the customer in the row. 
    
      ListItem item = new ListItem();
      item.Text = Server.HtmlDecode(row.Cells[2].Text);
            
      // If the customer is not already in the ListBox, add the ListItem
 
      // object to the Items collection of the ListBox control. 
      if (!CustomersListBox.Items.Contains(item))
      {
        CustomersListBox.Items.Add(item);
      }           
    }
  }

  void CustomersGridView_RowCreated(Object sender, GridViewRowEventArgs
 e)
  {
    
    // The GridViewCommandEventArgs class does not contain a 
    // property that indicates which row's command button was
    // clicked. To identify which row's button was clicked, use 
    // the button's CommandArgument property by setting it to the 
    // row's index.
    if(e.Row.RowType == DataControlRowType.DataRow)
    {
      // Retrieve the LinkButton control from the first column.
      LinkButton addButton = (LinkButton)e.Row.Cells[0].Controls[0];
          
      // Set the LinkButton's CommandArgument property with the
      // row's index.
      addButton.CommandArgument = e.Row.RowIndex.ToString();
    }

  }
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView RowCommand Example</h3>
            
      <table width="100%">         
        <tr>                
          <td width="50%">
                    
            <asp:gridview id="CustomersGridView" 
              datasourceid="CustomersSource"
              allowpaging="true" 
              autogeneratecolumns="false"
              onrowcommand="CustomersGridView_RowCommand"
              onrowcreated="CustomersGridView_RowCreated"  
              runat="server">
                
              <columns>
                <asp:buttonfield buttontype="Link" 
                  commandname="Add" 
                  text="Add"/>
                <asp:boundfield datafield="CustomerID" 
                  headertext="Customer ID"/>
                <asp:boundfield datafield="CompanyName" 
                  headertext="Company Name"/> 
                <asp:boundfield datafield="City" 
                  headertext="City"/>         
              </columns>
                
            </asp:gridview>
                    
          </td>
                    
          <td valign="top" width="50%">
                    
            Customers: <br/>
            <asp:listbox id="CustomersListBox"
              runat="server"/> 
                    
          </td>  
        </tr>      
      </table>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [City] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

プラットフォーム

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

参照

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

このページでは「.NET Framework クラスライブラリリファレンス」からGridView.RowCommand イベントを検索した結果を表示しています。
Weblioに収録されているすべての辞書からGridView.RowCommand イベントを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からGridView.RowCommand イベントを検索

>> 「GridView.RowCommand イベント」を含む用語の索引
GridView.RowCommand イベントのページへのリンク

GridView.RowCommand イベントとは？わかりやすく解説

GridView.RowCommand イベント

「GridView.RowCommand イベント」の関連用語


	© 2025 Microsoft.All rights reserved.

GridView.RowCommand イベントとは？ わかりやすく解説

GridView.RowCommand イベント

急上昇のことば

「GridView.RowCommand イベント」の関連用語

GridView.RowCommand イベントとは？わかりやすく解説