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

Значение true, если коллекция содержит DataRow с указанным значением первичного ключа; в противном случае — значение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 метод , объект, которому DataRowCollection принадлежит объект , DataTable должен иметь по крайней мере один столбец, назначенный в качестве первичного ключевого столбца. Дополнительные сведения о создании столбца 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

Значение true, если DataRowCollection содержит DataRow с указанным значением ключа; в противном случае — значение 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 метод с массивом значений, объект, которому DataRowCollection принадлежит объект, DataTable должен иметь массив столбцов, назначенных в качестве первичных ключей. PrimaryKey Дополнительные сведения о создании массива первичных ключевых столбцов см. в свойстве . Число элементов массива должно соответствовать количеству первичных ключевых столбцов в DataTable.

Как только вы определили, что строка содержит указанное значение, используйте Find метод , чтобы вернуть конкретный DataRow объект, имеющий значение .

См. также раздел

• PrimaryKey
• Find(Object)