DataRowCollection.Contains Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient une valeur qui indique si les colonnes clés primaires d'une ligne quelconque de la collection contiennent la valeur spécifiée.

Surcharges

Contains(Object)	Obtient une valeur qui indique si la clé primaire d'une ligne quelconque de la collection contient la valeur spécifiée.
Contains(Object[])	Obtient une valeur qui indique si les colonnes clés primaires d'une ligne quelconque de la collection contiennent les valeurs spécifiées dans le tableau d'objets.

Contains(Object)

Source:

DataRowCollection.cs

Obtient une valeur qui indique si la clé primaire d'une ligne quelconque de la collection contient la valeur spécifiée.

public:
 bool Contains(System::Object ^ key);

public bool Contains (object? key);

member this.Contains : obj -> bool

Public Function Contains (key As Object) As Boolean

Paramètres

key

Object

Valeur de la clé primaire à tester.

Retours

Boolean

true si la collection contient DataRow avec la valeur de clé primaire spécifiée ; sinon, false.

Exceptions

MissingPrimaryKeyException

La table ne possède pas de clé primaire.

Exemples

L’exemple Visual Basic suivant utilise la Contains méthode pour déterminer si un DataRowCollection objet contient une valeur spécifique.

 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

Remarques

Pour utiliser la Contains méthode , l’objet DataTable auquel appartient l’objet DataRowCollection doit avoir au moins une colonne désignée comme colonne de clé primaire. Pour plus d’informations sur la création d’une colonne de clé primaire, consultez la PrimaryKey propriété .

Dès que vous avez déterminé qu’une ligne contient la valeur spécifiée, vous pouvez utiliser la Find méthode pour renvoyer l’objet spécifique DataRow qui a la valeur .

Voir aussi

• PrimaryKey
• Find(Object)

Contains(Object[])

Source:

DataRowCollection.cs

Obtient une valeur qui indique si les colonnes clés primaires d'une ligne quelconque de la collection contiennent les valeurs spécifiées dans le tableau d'objets.

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

Paramètres

keys

Object[]

Tableau de valeurs de clés primaires à tester.

Retours

Boolean

true si DataRowCollection contient DataRow avec les valeurs de clés spécifiées ; sinon, false.

Exceptions

MissingPrimaryKeyException

La table ne possède pas de clé primaire.

Exemples

L’exemple Visual Basic suivant utilise la Contains méthode pour rechercher une ligne particulière dans un DataRowCollection objet . L’exemple crée un tableau de valeurs, un élément pour chaque clé primaire dans la table, puis transmet le tableau à la méthode pour retourner un 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

Remarques

Pour utiliser la Contains méthode avec un tableau de valeurs, l’objet DataTable auquel appartient l’objet DataRowCollection doit avoir un tableau de colonnes désignés comme clés primaires. Pour plus d’informations sur la création d’un tableau de colonnes clés primaires, consultez la PrimaryKey propriété . Le nombre d’éléments de tableau doit correspondre au nombre de colonnes clés primaires dans le DataTable.

Dès que vous avez déterminé qu’une ligne contient la valeur spécifiée, utilisez la Find méthode pour retourner l’objet spécifique DataRow qui a la valeur .

Voir aussi

• PrimaryKey
• Find(Object)