このコレクション内のいずれかの行の主キー列に、オブジェクト配列内で指定した値が格納されているかどうかを示す値を取得します。
Overloads Public Function Contains( _
ByVal keys() As Object _) As Boolean
[C#]
public bool Contains(object[] keys);
[C++]
public: bool Contains(Object* keys __gc[]);
[JScript]
public function Contains(
keys : Object[]) : Boolean;
パラメータ
- keys
確認する主キー値の配列。
戻り値
指定したキー値が格納されている DataRow が DataRowCollection 内にある場合は true 。それ以外の場合は false 。
例外
例外の種類 | 条件 |
---|---|
MissingPrimaryKeyException | このテーブルには主キーがありません。 |
解説
値の配列に Contains メソッドを使用するには、 DataRowCollection オブジェクトが属する DataTable オブジェクトに、主キー列として指定された列の配列が格納されている必要があります。主キー列の配列の作成の詳細については、 PrimaryKey プロパティのトピックを参照してください。配列の要素の数は、 DataTable 内の主キー列の数に対応している必要があります。
指定した値が行に格納されていると判断したら、 Find メソッドを使用して、その値が格納されている指定した DataRow オブジェクトを返すことができます。
使用例
[Visual Basic] Contains メソッドを使用して、 DataRowCollection オブジェクト内の特定の行を検索する例を次に示します。この例では、値の配列 (テーブル内の各主キーを配列の 1 要素にする) を作成し、 true または false を返すメソッドにこの配列を渡します。
Private Sub ContainsArray()
' This example assumes that the DataTable object contains at two
' DataColumn objects designated as primary keys.
Dim myTable As DataTable
Dim rc As DataRowCollection
' The table has two primary key columns.
Dim arrKeyVals(1) As Object
myTable = CType(DataGrid1.DataSource, DataTable)
rc = myTable.Rows
arrKeyVals(0) = "Hello"
arrKeyVals(1) = "World"
label1.Text = rc.Contains(arrKeyVals).ToString()
End Sub
[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
DataRowCollection クラス | DataRowCollection メンバ | System.Data 名前空間 | DataRowCollection.Contains オーバーロードの一覧 | PrimaryKey | Find