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

Значение 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[])

Возвращает значение, которое указывает, содержат ли столбцы первичного ключа любой из строк в коллекции значение, указанное в массиве объектов.

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

Значение 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)