DataRowCollection.Contains DataRowCollection.Contains DataRowCollection.Contains DataRowCollection.Contains Method

定義

このコレクション内のいずれかの行の主キー列に指定した値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the primary key columns of any row in the collection contain the specified value.

オーバーロード

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

このコレクション内のいずれかの行の主キーに指定した値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

Contains(Object[]) Contains(Object[]) Contains(Object[]) Contains(Object[])

このコレクション内のいずれかの行の主キー列に、オブジェクト配列内で指定した値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

このコレクション内のいずれかの行の主キーに指定した値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the primary key of any row in the collection contains the specified value.

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 Object Object Object

確認する主キーの値。The value of the primary key to test for.

戻り値

指定した主キー値が格納されている DataRow がコレクション内にある場合は true。それ以外の場合は falsetrue if the collection contains a DataRow with the specified primary key value; otherwise, false.

例外

このテーブルには主キーがありません。The table does not have a primary key.

次の Visual Basic 例ではContains 、メソッドを使用しDataRowCollectionて、オブジェクトに特定の値が含まれているかどうかを確認します。The following Visual Basic example uses the Contains method to determine whether a DataRowCollection object contains a specific value.

 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メソッドを使用するにはDataTableDataRowCollectionオブジェクトが属しているオブジェクトに、少なくとも1つの列が主キー列として指定されている必要があります。To use the Contains method, the DataTable object to which the DataRowCollection object belongs to must have at least one column designated as a primary key column. 主キー PrimaryKey列の作成方法の詳細については、プロパティを参照してください。See the PrimaryKey property for more information about how to create a primary key column.

指定した値が行に含まれていると判断したら、 Findメソッドを使用して、値を持つ特定DataRowのオブジェクトを返すことができます。As soon as you have determined that a row contains the specified value, you can use the Find method to return the specific DataRow object that has the value.

こちらもご覧ください

Contains(Object[]) Contains(Object[]) Contains(Object[]) Contains(Object[])

このコレクション内のいずれかの行の主キー列に、オブジェクト配列内で指定した値が格納されているかどうかを示す値を取得します。Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.

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[]

確認する主キー値の配列。An array of primary key values to test for.

戻り値

指定したキー値が格納されている DataRowCollectionDataRow 内にある場合は true。それ以外の場合は falsetrue if the DataRowCollection contains a DataRow with the specified key values; otherwise, false.

例外

このテーブルには主キーがありません。The table does not have a primary key.

次の Visual Basic 例ではContains 、メソッドを使用して、 DataRowCollectionオブジェクト内の特定の行を検索します。The following Visual Basic example uses the Contains method to find a particular row in a DataRowCollection object. この例では、値の配列を作成し、テーブルの主キーごとに1つの要素を作成します。次にtruefalse配列をメソッドに渡して、またはを返します。The example creates an array of values, one element for each primary key in the table, and then passes the array to the method to return a true or 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 の配列DataRowCollectionでメソッドを使用するには、オブジェクトが属するオブジェクトが主キーとして指定された列の配列を持っている必要があります。DataTableTo use the Contains method with an array of values, the DataTable object to which the DataRowCollection object belongs must have an array of columns designated as primary keys. 主キー PrimaryKey列の配列を作成する方法の詳細については、プロパティを参照してください。See the PrimaryKey property for more information about how to create an array of primary key columns. 配列要素の数は、 DataTable内の主キー列の数に対応している必要があります。The number of array elements must correspond to the number of primary key columns in the DataTable.

指定した値が行に含まれていると判断したら、 Findすぐにメソッドを使用DataRowして、値を持つ特定のオブジェクトを返します。As soon as you have determined that a row contains the specified value, use the Find method to return the specific DataRow object that has the value.

こちらもご覧ください

適用対象