DataRowCollection.Contains 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

获取一个值，该值表明集合中任何行的主键列是否包含指定值。

重载

Contains(Object)	获取一个值，该值指示集合中任何行的主键中是否包含指定的值。
Contains(Object[])	获取一个值，该值指示集合中任何行的主键列中是否包含在对象数组中指定的值。

Contains(Object)

Source:

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 所属的对象必须至少有一个列指定为主键列。 有关如何创建主键列的详细信息， PrimaryKey 请参阅 属性。

一旦确定某行包含指定的值，就可以使用 Find 方法返回具有该值的特定 DataRow 对象。

另请参阅

• PrimaryKey
• Find(Object)

Contains(Object[])

Source:

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 特定行。 该示例创建一个值数组，表中每个主键对应一个元素，然后将该数组传递给 方法以返回 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)