DataRowCollection.Contains Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.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

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)

Origem:

DataRowCollection.cs

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 especificado da chave primária; 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

• PrimaryKey
• Find(Object)

Contains(Object[])

Origem:

DataRowCollection.cs

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 os quais testar.

Retornos

Boolean

true se o DataRowCollection contiver 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 encontrar 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ê determinar 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

• PrimaryKey
• Find(Object)