DataTableCollection.Contains Méthode

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

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

Surcharges

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

Contains(String)

Source:

DataTableCollection.cs

Obtient une valeur qui indique si un DataTable objet 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 de la DataTable recherche.

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 DataTableCollectionfichier .

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 DataTable à l’aide de la TableName propriété. Si vous ajoutez une DataTable à la collection avec la Add méthode, en passant aucun argument, 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.

Note

Retourne false quand deux tables ou plus ont le même nom, mais des espaces de noms différents. L’appel ne réussit pas s’il existe une ambiguïté lors de la correspondance d’un nom de table à une seule table.

Voir aussi

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

Contains(String, String)

Source:

DataTableCollection.cs

Obtient une valeur qui indique si un DataTable objet portant le nom et l’espace de noms de table spécifiés existent 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 de la DataTable recherche.

tableNamespace

String

Nom de l’espace DataTable de noms à 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 DataTableCollectionfichier .

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 DataTable à l’aide de la TableName propriété. Si vous ajoutez une DataTable à la collection avec la Add méthode, en passant aucun argument, 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.).

Note

Retourne false quand deux tables ou plus ont le même nom, mais des espaces de noms différents. L’appel ne réussit pas s’il existe une ambiguïté lors de la correspondance d’un nom de table à une seule table.

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

Voir aussi

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