DataRowCollection.Contains メソッド

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

アセンブリ:

System.Data.dll

アセンブリ:

netstandard.dll

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

オーバーロード

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

Contains(Object)

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

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

public bool Contains (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[])

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

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

public bool Contains (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 つの要素である値の配列を作成し、その配列をメソッドに渡して、 true 値または false.

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)