GridViewRowCollection クラスとは何？わかりやすく解説 Weblio辞書

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

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

GridViewRowCollection クラス

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

GridView コントロール内の GridViewRow オブジェクトのコレクションを表します。

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

Visual Basic (宣言)

Public Class GridViewRowCollection
    Implements ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As GridViewRowCollection

public class GridViewRowCollection : ICollection,
 IEnumerable

C++

public ref class GridViewRowCollection : ICollection,
 IEnumerable

public class GridViewRowCollection implements
 ICollection, IEnumerable

JScript

public class GridViewRowCollection implements
 ICollection, IEnumerable

解説

GridViewRowCollection クラスは、GridView コントロール内の GridViewRow オブジェクトのコレクションを格納および管理する場合に使用されます。GridView コントロール内の各行は、GridViewRow オブジェクトによって表されます。GridView コントロールは、すべてのデータ行を Rows コレクションに格納します。

GridViewRowCollection クラスは、コレクション内の項目にアクセスするための複数の方法をサポートしています。

0 から始まるインデックスの特定の位置にある GridViewRow オブジェクトを直接取得するには、Item インデクサを使用します。
コレクションを反復処理するために使用できる列挙子を取得するには、GetEnumerator メソッドを使用します。
CopyTo メソッドを使用して、コレクションの項目を System.Array オブジェクトにコピーします。その後、このオブジェクトを使用して、コレクションの項目にアクセスできます。

コレクション内の合計項目数を確認するには、Count プロパティを使用します。

使用例

GridView コントロールの Rows コレクションを反復処理して、ページの列の値を表示する方法を次の例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub AuthorsGridView_RowCreated(ByVal sender
 As Object, ByVal e As
 GridViewRowEventArgs)

    If e.Row.RowType = DataControlRowType.Footer Then
      
      ' Get the number of items in the Rows collection.
      Dim count As Integer
 = AuthorsGridView.Rows.Count

      ' If the GridView control contains any records, display 
      ' the last name of each author in the GridView control.
      If count > 0 Then
           
        Message.Text = "The authors are:<br>"
        
        Dim row As GridViewRow
        For Each row In
 AuthorsGridView.Rows
        
          Message.Text &= row.Cells(0).Text & "<br>"
        
        Next
        
      End If
        
    End If
        
  End Sub

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewRowCollection Example</h3>

      <table>
        <tr>
          <td>
            <asp:gridview id="AuthorsGridView"
 
              datasourceid="AuthorsSqlDataSource"
 
              autogeneratecolumns="false"
              onrowcreated="AuthorsGridView_RowCreated"
  
              runat="server"> 
                     
              <columns>
                <asp:boundfield datafield="au_lname"
                  headertext="Last Name"/>
                <asp:boundfield datafield="au_fname"
                  headertext="First Name"/>
              </columns>
                                    
            </asp:gridview>
          </td>
          <td>
            <asp:label id="Message" 
              forecolor="Red"
              runat="server"/>
          </td>
        </tr>
      </table>
            
      <!-- This example uses Microsoft SQL Server and connects
 -->
      <!-- to the Pubs sample database.                   
     -->
      <asp:sqldatasource id="AuthorsSqlDataSource"
  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
        connectionstring="server=localhost;database=pubs;integrated
 security=SSPI"
        runat="server">
      </asp:sqldatasource>
          
    </form>
  </body>
</html>

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

<script runat="server">

  void AuthorsGridView_RowCreated(Object sender, GridViewRowEventArgs
 e)
  {
    if (e.Row.RowType == DataControlRowType.Footer)
    {      
      
      // Get the number of items in the Rows collection.
      int count = AuthorsGridView.Rows.Count;

      // If the GridView control contains any records, display 
      // the last name of each author in the GridView control.
      if (count > 0)
      {      
        Message.Text = "The authors are:<br>";
        
        foreach (GridViewRow row in AuthorsGridView.Rows)
        {
          Message.Text += row.Cells[0].Text + "<br>";
        }
      }
      
    }
  }

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewRowCollection Example</h3>

      <table>
        <tr>
          <td>
            <asp:gridview id="AuthorsGridView" 
              datasourceid="AuthorsSqlDataSource" 
              autogeneratecolumns="false"
              onrowcreated="AuthorsGridView_RowCreated"  
              runat="server"> 
                     
              <columns>
                <asp:boundfield datafield="au_lname"
                  headertext="Last Name"/>
                <asp:boundfield datafield="au_fname"
                  headertext="First Name"/>
              </columns>
                                    
            </asp:gridview>
          </td>
          <td>
            <asp:label id="Message" 
              forecolor="Red"
              runat="server"/>
          </td>
        </tr>
      </table>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors] WHERE [state]='CA'"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
          
    </form>
  </body>
</html>