DataRowCollection.Contains Método

Definição

Espaço de Nomes:
System.Data
Assemblagens:
netstandard.dll, System.Data.Common.dll
Assemblagem:
System.Data.Common.dll
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém um valor que indica se as colunas principais de qualquer linha da coleção contêm o valor especificado.

Sobrecargas

Name Description
Contains(Object)

Recebe um valor que indica se a chave primária de qualquer linha da coleção contém o valor especificado.
Contains(Object[])

Obtém um valor que indica se as colunas principais de qualquer linha da coleção contêm os valores especificados no array de objetos.

Contains(Object)

Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs

Recebe um valor que indica se a chave primária de qualquer linha da coleção contém o valor especificado.

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

Parâmetros

key
Object

O valor da chave principal a testar.

Devoluções

Boolean

true se a coleção contiver a DataRow com o valor da chave primária especificado; caso contrário, false.

Exceções

MissingPrimaryKeyException

A tabela não tem uma chave primária.

Exemplos

O exemplo Visual Basic seguinte utiliza o método Contains para determinar se um objeto DataRowCollection contém um valor específico.

 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

Observações

Para usar o Contains método, o DataTable objeto ao qual pertence DataRowCollection deve ter pelo menos uma coluna designada como coluna chave primária. Consulte a PrimaryKey propriedade para mais informações sobre como criar uma coluna chave primária.

Assim que determinar que uma linha contém o valor especificado, pode usar o Find método para devolver o objeto específico DataRow que tem esse valor.

Ver também

Aplica-se a

Contains(Object[])

Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs
Origem:
DataRowCollection.cs

Obtém um valor que indica se as colunas principais de qualquer linha da coleção contêm os valores especificados no array de objetos.

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

Parâmetros

keys
Object[]

Um conjunto de valores-chave primárias para testar.

Devoluções

Boolean

true se o DataRowCollection contiver a DataRow com os valores de chave especificados; caso contrário, false.

Exceções

MissingPrimaryKeyException

A tabela não tem uma chave primária.

Exemplos

O exemplo Visual Basic seguinte utiliza o método Contains para encontrar uma linha particular num objeto DataRowCollection. O exemplo cria um array de valores, um elemento para cada chave primária na tabela, e depois passa o array ao método para devolver um true ou 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

Observações

Para usar o Contains método com um array de valores, o DataTable objeto ao qual pertence DataRowCollection deve ter um array de colunas designadas como chaves primárias. Consulte a PrimaryKey propriedade para mais informações sobre como criar um array de colunas principais primárias. O número de elementos do array deve corresponder ao número de colunas principais primárias no DataTable.

Assim que determinar que uma linha contém o valor especificado, use o Find método para devolver o objeto específico DataRow que tem esse valor.

Ver também

Aplica-se a