DetailsViewRowCollection DetailsViewRowCollection DetailsViewRowCollection DetailsViewRowCollection Class

定義

DetailsViewRow コントロールに含まれる DetailsView オブジェクトのコレクションを表します。Represents a collection of DetailsViewRow objects in a DetailsView control.

public ref class DetailsViewRowCollection : System::Collections::ICollection
public class DetailsViewRowCollection : System.Collections.ICollection
type DetailsViewRowCollection = class
    interface ICollection
    interface IEnumerable
Public Class DetailsViewRowCollection
Implements ICollection
継承
DetailsViewRowCollectionDetailsViewRowCollectionDetailsViewRowCollectionDetailsViewRowCollection
実装

次のコード例は、 DetailsViewRow DetailsViewコントロールのRowsコレクション内のオブジェクトを反復処理する方法を示しています。The following code example demonstrates how to iterate through the DetailsViewRow objects in the Rows collection of a DetailsView control. 次に、各行の値がページに表示されます。The value of each row is then displayed on the page.


<%@ 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 SubmitButton_Click(Object sender, EventArgs e)
  {

    // Use the Count property to determine whether the
    // Rows collection contains any item.
    if (ItemDetailsView.Rows.Count > 0)
    {
      // Iterate through the Rows collection and display
      // the value of each field.
      MessageLabel.Text = "The row values are: <br/><br/>";

      foreach (DetailsViewRow row in ItemDetailsView.Rows)
      {
        // Use the Text property to access the value of 
        // each cell. In this example, the cells in the 
        // first column (index 0) contains the field names, 
        // while the cells in the second column (index 1)
        // contains the field value. 
        MessageLabel.Text += row.Cells[0].Text + " = " +
          row.Cells[1].Text + "<br/>";
      }
    }
    else
    {
      MessageLabel.Text = "No items.";
    }

  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewRowCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>DetailsViewRowCollection Example</h3>
  
      <asp:detailsview id="ItemDetailsView"
        datasourceid="DetailsViewSource"
        allowpaging="true"
        autogeneraterows="false" 
        runat="server">
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </fields>
      </asp:detailsview>
      
      <br/>
      
      <asp:button id="SubmitButton" 
        text="Display Row Values"
        onclick="SubmitButton_Click"
        runat="server"/>
        
      <br/><br/>
      
      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>
      
      <!-- 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="DetailsViewSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], 
          [City], [PostalCode], [Country] From [Customers]"
        connectionstring=
          "<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>  
  
    </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 SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
 
    ' Use the Count property to determine whether the
    ' Rows collection contains any item.
    If ItemDetailsView.Rows.Count > 0 Then
    
      ' Iterate through the Rows collection and display
      ' the value of each field.
      MessageLabel.Text = "The row values are: <br/><br/>"
    
      Dim row As DetailsViewRow
    
      For Each row In ItemDetailsView.Rows
    
        ' Use the Text property to access the value of 
        ' each cell. In this example, the cells in the 
        ' first column (index 0) contains the field names, 
        ' while the cells in the second column (index 1)
        ' contains the field value. 
        MessageLabel.Text &= row.Cells(0).Text & " = " & _
          row.Cells(1).Text & "<br/>"
    
      Next
    
    Else
      
      MessageLabel.Text = "No items."
    
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewRowCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>DetailsViewRowCollection Example</h3>
  
      <asp:detailsview id="ItemDetailsView"
        datasourceid="DetailsViewSource"
        allowpaging="true"
        autogeneraterows="false" 
        runat="server">
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </fields>
      </asp:detailsview>
      
      <br/>
      
      <asp:button id="SubmitButton" 
        text="Display Row Values"
        onclick="SubmitButton_Click"
        runat="server"/>
        
      <br/><br/>
      
      <asp:label id="MessageLabel"
        forecolor="Red"
        runat="server"/>
      
      <!-- 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="DetailsViewSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], 
          [City], [PostalCode], [Country] From [Customers]"
        connectionstring=
          "<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>  
  
    </form>
  </body>
</html>

注釈

クラスは、 DetailsViewコントロール内のオブジェクトのDetailsViewRowコレクションを格納および管理するために使用されます。 DetailsViewRowCollectionThe DetailsViewRowCollection class is used to store and manage a collection of DetailsViewRow objects in a DetailsView control. DetailsViewコントロール内の各行は、 DetailsViewRowオブジェクトによって表されます。Each row in a DetailsView control is represented by a DetailsViewRow object. コントロールDetailsViewは、 RowsプロパティDetailsViewRowCollectionにクラスを使用します。The DetailsView control uses the DetailsViewRowCollection class for its Rows property.

注意

プロパティRowsには、データ行のみが含まれます。The Rows property contains only the data rows. ヘッダー行、フッター行、上部のページ行、および下のページ行にアクセスするにHeaderRowFooterRowTopPagerRowそれぞれ、 BottomPagerRow 、、およびの各プロパティを使用します。To access the header row, footer row, top pager row, and bottom pager row, use the HeaderRow, FooterRow, TopPagerRow, and BottomPagerRow properties, respectively.

クラスDetailsViewRowCollectionは、コレクション内の項目にアクセスするためのいくつかの方法をサポートしています。The DetailsViewRowCollection class supports several ways to access the items in the collection:

  • インデクサーを使用して、特定DetailsViewRowの0から始まるインデックスでコレクションからオブジェクトを直接取得します。 Item[Int32]Use the Item[Int32] indexer to directly retrieve a DetailsViewRow object from the collection at a specific zero-based index.

  • コレクションをGetEnumerator反復処理するために使用できる列挙子を取得するには、メソッドを使用します。Use the GetEnumerator method to retrieve an enumerator that can be used to iterate through the collection.

  • CopyToメソッドを使用して、コレクション内の項目を配列にコピーします。この配列を使用して、コレクション内の項目にアクセスできます。Use the CopyTo method to copy the items in the collection into an array, which can then be used to access the items in the collection.

コレクション内の項目の合計数を確認するには、 Countプロパティを使用します。To determine the total number of items in the collection, use the Count property.

コンストラクター

DetailsViewRowCollection(ArrayList) DetailsViewRowCollection(ArrayList) DetailsViewRowCollection(ArrayList) DetailsViewRowCollection(ArrayList)

指定した ArrayList オブジェクトを使用して、DetailsViewRowCollection クラスの新しいインスタンスを初期化します。Initializes a new instance of the DetailsViewRowCollection class using the specified ArrayList object.

プロパティ

Count Count Count Count

DetailsViewRowCollection オブジェクト内の項目の数を取得します。Gets the number of items in the DetailsViewRowCollection object.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

DetailsViewRowCollection オブジェクト内の行を変更できるかどうかを示す値を取得します。Gets a value indicating whether the rows in the DetailsViewRowCollection object can be modified.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

DetailsViewRowCollection オブジェクトが同期されている (スレッド セーフである) かどうかを示す値を取得します。Gets a value indicating whether the DetailsViewRowCollection object is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

指定されたインデックス位置にある DetailsViewRow オブジェクトをコレクションから取得します。Gets the DetailsViewRow object from the collection at the specified index.

SyncRoot SyncRoot SyncRoot SyncRoot

コレクションへのアクセスを同期するために使用するオブジェクトを取得します。Gets the object used to synchronize access to the collection.

メソッド

CopyTo(DetailsViewRow[], Int32) CopyTo(DetailsViewRow[], Int32) CopyTo(DetailsViewRow[], Int32) CopyTo(DetailsViewRow[], Int32)

この DetailsViewRowCollection オブジェクトからすべての項目を、指定した Array オブジェクトに、Array 内の指定したインデックス位置からコピーします。Copies all the items from this DetailsViewRowCollection object to the specified Array object, starting at the specified index in the Array.

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

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

DetailsViewRow オブジェクト内のすべての DetailsViewRowCollection オブジェクトを格納する列挙子を返します。Returns an enumerator that contains all DetailsViewRow objects in the DetailsViewRowCollection 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)

明示的なインターフェイスの実装

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

この DetailsViewRowCollection オブジェクトからすべての項目を、指定した Array オブジェクトに、Array 内の指定したインデックス位置からコピーします。Copies all the items from this DetailsViewRowCollection object to the specified Array object, starting at the specified index in the Array.

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください