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

DataRowCollection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	オーバーライドされます。 このコレクション内の DataRow オブジェクトの合計数を取得します。
	IsReadOnly	InternalDataCollectionBase が読み取り専用かどうかを示す値を取得します。 ( InternalDataCollectionBase から継承されます。)
	IsSynchronized	InternalDataCollectionBase の同期がとられているかどうかを示す値を取得します。 ( InternalDataCollectionBase から継承されます。)
	SyncRoot	コレクションの同期をとるために使用できるオブジェクトを取得します。 ( InternalDataCollectionBase から継承されます。)

プロテクト プロパティ

	名前	説明
	List	オーバーライドされます。

参照

関連項目

DataRowCollection クラス
System.Data 名前空間
DataRow クラス
DataTable
NewRow

DataRowCollection メソッド

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 DataRow を DataRowCollection に追加します。
	Clear	すべての行のコレクションを消去します。
	Contains	オーバーロードされます。 このコレクション内のいずれかの行の主キー列に指定した値が格納されているかどうかを示す値を取得します。
	CopyTo	オーバーロードされます。 オーバーライドされます。 このコレクション内のすべての DataRow オブジェクトを、指定したコピー先配列インデックスから始まる指定した配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Find	オーバーロードされます。 指定した DataRow を取得します。
	GetEnumerator	オーバーライドされます。 このコレクションの IEnumerator を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	指定した DataRow オブジェクトのインデックスを取得します。
	InsertAt	コレクション内の指定した位置に新しい行を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定した DataRow をコレクションから削除します。
	RemoveAt	指定したインデックス位置にある行をコレクションから削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

DataRowCollection クラス
System.Data 名前空間
DataRow クラス
DataTable
NewRow

DataRowCollection メンバ

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

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

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	オーバーライドされます。 このコレクション内の DataRow オブジェクトの合計数を取得します。
	IsReadOnly	InternalDataCollectionBase が読み取り専用かどうかを示す値を取得します。(InternalDataCollectionBase から継承されます。)
	IsSynchronized	InternalDataCollectionBase の同期がとられているかどうかを示す値を取得します。(InternalDataCollectionBase から継承されます。)
	SyncRoot	コレクションの同期をとるために使用できるオブジェクトを取得します。(InternalDataCollectionBase から継承されます。)

プロテクト プロパティ

	名前	説明
	List	オーバーライドされます。

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 DataRow を DataRowCollection に追加します。
	Clear	すべての行のコレクションを消去します。
	Contains	オーバーロードされます。 このコレクション内のいずれかの行の主キー列に指定した値が格納されているかどうかを示す値を取得します。
	CopyTo	オーバーロードされます。 オーバーライドされます。 このコレクション内のすべての DataRow オブジェクトを、指定したコピー先配列インデックスから始まる指定した配列にコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Find	オーバーロードされます。 指定した DataRow を取得します。
	GetEnumerator	オーバーライドされます。 このコレクションの IEnumerator を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	指定した DataRow オブジェクトのインデックスを取得します。
	InsertAt	コレクション内の指定した位置に新しい行を挿入します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定した DataRow をコレクションから削除します。
	RemoveAt	指定したインデックス位置にある行をコレクションから削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

DataRowCollection クラス
System.Data 名前空間
DataRow クラス
DataTable
NewRow