DataRowCollection クラス

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

DataRowCollection クラス

DataTable の行のコレクションを表します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 DataRowCollection
    Inherits InternalDataCollectionBase

Visual Basic (使用法)

Dim instance As DataRowCollection

C#

public sealed class DataRowCollection : InternalDataCollectionBase

C++

public ref class DataRowCollection sealed :
 public InternalDataCollectionBase

J#

public final class DataRowCollection extends
 InternalDataCollectionBase

JScript

public final class DataRowCollection extends
 InternalDataCollectionBase

解説

DataRowCollection は DataTable の主要コンポーネントです。DataColumnCollection がテーブルのスキーマを定義するのに対して、DataRowCollection はテーブルの実際のデータを格納します。DataRowCollection に格納された各 DataRow は単一行を表します。

DataRowCollection に DataRow オブジェクトを挿入するには Add メソッドを呼び出し、オブジェクトを削除するには Remove メソッドを呼び出します。主キー列内の特定の値を格納する DataRow オブジェクトを検索するには Find メソッドを呼び出し、文字ベースのデータ内にある単一の単語または語句を検索するには Contains メソッドを呼び出します。

使用例

このセクションの最初の例では、DataRowCollection 内の各行の列 1 の値を出力します。2 番目の例では、NewRow メソッドを使用して作成した新しい行を DataRowCollection に追加します。

Visual Basic

Private Sub ShowRows(Byval
 table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal
 table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

C#

private void ShowRows(DataTable table)
{
    // Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count);
    // Print the value of columns 1 in each row
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[1]);
    }
}
 
private void AddRow(DataTable table)
{
    DataRowCollection rowCollection = table.Rows;
    // Instantiate a new row using the NewRow method.

    DataRow newRow = table.NewRow();
    // Insert code to fill the row with values.

    // Add the row to the DataRowCollection.
    table.Rows.Add(newRow);
}

継承階層

System.Object
   System.Data.InternalDataCollectionBase
    System.Data.DataRowCollection

スレッド セーフ

この型は、マルチスレッド読み取り操作に対して安全です。すべての書き込み操作の同期をとる必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataRowCollection メンバ
System.Data 名前空間
DataRow クラス
DataTable
NewRow