DataRowCollection.Contains メソッド

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

このコレクション内のいずれかの行の主キー列に指定した値が格納されているかどうかを示す値を取得します。

オーバーロード

Contains(Object)	このコレクション内のいずれかの行の主キーに指定した値が格納されているかどうかを示す値を取得します。
Contains(Object[])	このコレクション内のいずれかの行の主キー列に、オブジェクト配列内で指定した値が格納されているかどうかを示す値を取得します。

Contains(Object)

ソース:

DataRowCollection.cs

このコレクション内のいずれかの行の主キーに指定した値が格納されているかどうかを示す値を取得します。

public:
 bool Contains(System::Object ^ key);

public bool Contains (object? key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

パラメーター

key

Object

確認する主キーの値。

戻り値

Boolean

指定した主キー値が格納されている DataRow がコレクション内にある場合は true。それ以外の場合は false。

例外

MissingPrimaryKeyException

このテーブルには主キーがありません。

例

次の Visual Basic の例では、 メソッドを Contains 使用して、オブジェクトに DataRowCollection 特定の値が含まれているかどうかを判断します。

 Private Sub ColContains()
    Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
    Dim rowCollection As DataRowCollection = table.Rows
    If rowCollection.Contains(Edit1.Text) Then
       Label1.Text = "At least one row contains " & Edit1.Text 
    Else
       Label1.Text = "No row contains the value in its primary key field"
    End If
End Sub

注釈

メソッドを Contains 使用するには、オブジェクトが DataTable 属する DataRowCollection オブジェクトに、主キー列として指定された列が少なくとも 1 つ必要です。 主キー列を PrimaryKey 作成する方法の詳細については、 プロパティを参照してください。

指定した値が行に含まれていると判断するとすぐに、 メソッドを Find 使用して、値を持つ特定 DataRow のオブジェクトを返すことができます。

こちらもご覧ください

• PrimaryKey
• Find(Object)

Contains(Object[])

ソース:

DataRowCollection.cs

このコレクション内のいずれかの行の主キー列に、オブジェクト配列内で指定した値が格納されているかどうかを示す値を取得します。

public:
 bool Contains(cli::array <System::Object ^> ^ keys);

public bool Contains (object?[] keys);

member this.Contains : obj[] -> bool

Public Function Contains (keys As Object()) As Boolean

パラメーター

keys

Object[]

確認する主キー値の配列。

戻り値

Boolean

指定したキー値が格納されている DataRowCollection が DataRow 内にある場合は true。それ以外の場合は false。

例外

MissingPrimaryKeyException

このテーブルには主キーがありません。

例

次の Visual Basic の例では、 メソッドを Contains 使用して オブジェクト内の特定の行を DataRowCollection 検索します。 この例では、テーブル内の主キーごとに 1 つの要素である値の配列を作成し、その配列を メソッドに渡して または falseを返trueします。

Private Sub ContainsArray()
   ' This example assumes that the DataTable object contains two
   ' DataColumn objects designated as primary keys.
   ' The table has two primary key columns.
   Dim arrKeyVals(1) As Object
   Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)
   Dim rowCollection As DataRowCollection = table.Rows
   arrKeyVals(0) = "Hello"
   arrKeyVals(1) = "World"
   label1.Text = rowCollection.Contains(arrKeyVals).ToString()
End Sub

注釈

値の Contains 配列で メソッドを使用するには、オブジェクトが DataTable 属する DataRowCollection オブジェクトに主キーとして指定された列の配列が必要です。 主キー列の PrimaryKey 配列を作成する方法の詳細については、 プロパティを参照してください。 配列要素の数は、 の主キー列の数に対応している DataTable必要があります。

指定した値が行に含まれていると判断したらすぐに、 メソッドを Find 使用して、値を持つ特定 DataRow のオブジェクトを返します。

こちらもご覧ください

• PrimaryKey
• Find(Object)