DataRowCollection.Contains Método

Definição

Namespace:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Obtém um valor que indica se as colunas de chave primária de qualquer linha na coleção contêm o valor especificado.

Sobrecargas

Nome Description
Contains(Object)

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

Obtém um valor que indica se as colunas de chave primária de qualquer linha na coleção contêm os valores especificados na matriz de objetos.

Contains(Object)

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

public:
 bool Contains(System::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 primária para a qual testar.

Retornos

Boolean

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

Exceções

MissingPrimaryKeyException

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

Exemplos

O exemplo do Visual Basic a seguir usa o Contains método para determinar se um DataRowCollection objeto 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

Comentários

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

Assim que você determinou que uma linha contém o valor especificado, você pode usar o Find método para retornar o objeto específico DataRow que tem o valor.

Confira também

Aplica-se a

Contains(Object[])

Obtém um valor que indica se as colunas de chave primária de qualquer linha na coleção contêm os valores especificados na matriz de objetos.

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

Parâmetros

keys
Object[]

Uma matriz de valores de chave primária para o qual testar.

Retornos

Boolean

true se o DataRowCollection contém um 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 do Visual Basic a seguir usa o Contains método para localizar uma linha específica em um DataRowCollection objeto. O exemplo cria uma matriz de valores, um elemento para cada chave primária na tabela e, em seguida, passa a matriz para o método para retornar 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

Comentários

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

Assim que você tiver determinado que uma linha contém o valor especificado, use o Find método para retornar o objeto específico DataRow que tem o valor.

Confira também

Aplica-se a