DataTableCollection.Contains Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient une valeur indiquant s'il existe dans la collection un objet DataTable portant le nom spécifié.

Surcharges

Contains(String)	Obtient une valeur qui indique si un objet DataTable portant le nom spécifié existe dans la collection.
Contains(String, String)	Obtient une valeur qui indique si un objet DataTable portant le nom et l'espace de noms spécifié existe dans la collection.

Contains(String)

Source:

DataTableCollection.cs

Obtient une valeur qui indique si un objet DataTable portant le nom spécifié existe dans la collection.

public:
 bool Contains(System::String ^ name);

public bool Contains (string? name);

member this.Contains : string -> bool

Public Function Contains (name As String) As Boolean

Paramètres

name

String

Nom du DataTable à rechercher.

Retours

Boolean

true si la table spécifiée existe ; sinon, false.

Exemples

L’exemple suivant teste si une table portant le nom « Fournisseurs » existe dans le DataTableCollection.

private void TestForTableName()
{
    // Get the DataSet of a DataGrid.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Get the DataTableCollection through the Tables property.
    DataTableCollection tablesCol = thisDataSet.Tables;

    // Check if the named table exists.
    if (tablesCol.Contains("Suppliers"))
        Console.WriteLine("Table named Suppliers exists");
}

Private Sub TestForTableName()
   ' Get the DataSet of a DataGrid.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

   ' Get the DataTableCollection through the Tables property.
   Dim tablesCol As DataTableCollection = thisDataSet.Tables

   ' Check if the named table exists.
   If tablesCol.Contains("Suppliers") Then 
      Console.WriteLine("Table named Suppliers exists")
   End If
End Sub

Remarques

Vous spécifiez le nom de l’objet à l’aide DataTable de la TableName propriété . Si vous ajoutez un DataTable à la collection avec la Add méthode, sans passer d’arguments, la table reçoit un nom par défaut, en fonction de l’ordre dans lequel la table a été ajoutée (« Table1 », « Table2 », etc.).

Pour obtenir l’index d’un DataTable, utilisez la IndexOf méthode .

Notes

Retourne false lorsque deux tables ou plus ont le même nom, mais des espaces de noms différents. L'appel ne réussit pas en cas d'ambiguïté lors de la mise en correspondance d'un nom de table avec exactement une table.

Voir aussi

• Item[Int32]
• IndexOf(DataTable)
• Remove(DataTable)
• CanRemove(DataTable)

Contains(String, String)

Source:

DataTableCollection.cs

Obtient une valeur qui indique si un objet DataTable portant le nom et l'espace de noms spécifié existe dans la collection.

public:
 bool Contains(System::String ^ name, System::String ^ tableNamespace);

public bool Contains (string name, string tableNamespace);

member this.Contains : string * string -> bool

Public Function Contains (name As String, tableNamespace As String) As Boolean

Paramètres

name

String

Nom du DataTable à rechercher.

tableNamespace

String

Nom de l'espace de noms DataTable dans lequel rechercher.

Retours

Boolean

true si la table spécifiée existe ; sinon, false.

Exemples

L’exemple suivant teste si une table portant le nom « Fournisseurs » existe dans le DataTableCollection.

private void TestForTableName()
{
    // Get the DataSet of a DataGrid.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Get the DataTableCollection through the Tables property.
    DataTableCollection tablesCol = thisDataSet.Tables;

    // Check if the named table exists.
    if (tablesCol.Contains("Suppliers"))
        Console.WriteLine("Table named Suppliers exists");
}

Private Sub TestForTableName()
   ' Get the DataSet of a DataGrid.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

   ' Get the DataTableCollection through the Tables property.
   Dim tablesCol As DataTableCollection = thisDataSet.Tables

   ' Check if the named table exists.
   If tablesCol.Contains("Suppliers") Then 
      Console.WriteLine("Table named Suppliers exists")
   End If
End Sub

Remarques

Vous spécifiez le nom de l’objet à l’aide DataTable de la TableName propriété . Si vous ajoutez un DataTable à la collection avec la Add méthode, sans passer d’arguments, la table reçoit un nom par défaut, en fonction de l’ordre dans lequel la table a été ajoutée (« Table1 », « Table2 », etc.).

Notes

Retourne false lorsque deux tables ou plus ont le même nom, mais des espaces de noms différents. L'appel ne réussit pas en cas d'ambiguïté lors de la mise en correspondance d'un nom de table avec exactement une table.

Pour obtenir l’index d’un DataTable, utilisez la IndexOf méthode .

Voir aussi

• Item[Int32]
• IndexOf(DataTable)
• Remove(DataTable)
• CanRemove(DataTable)