DataTableCollection.Add Méthode

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un objet DataTable à la collection.

Surcharges

Add()	Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.
Add(DataTable)	Ajoute l'objet `DataTable` spécifié à la collection.
Add(String)	Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.
Add(String, String)	Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.

Add()

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.

public:
 System::Data::DataTable ^ Add();

public:
 virtual System::Data::DataTable ^ Add();

public System.Data.DataTable Add ();

public virtual System.Data.DataTable Add ();

member this.Add : unit -> System.Data.DataTable

abstract member Add : unit -> System.Data.DataTable
override this.Add : unit -> System.Data.DataTable

Public Function Add () As DataTable

Public Overridable Function Add () As DataTable

Retours

DataTable

Objet DataTable nouvellement créé.

Exemples

L’exemple suivant ajoute trois nouveaux DataTable objets à l’aide de DataTableCollection la Add méthode sans arguments.

private void AddTables()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    for (int i = 0; i < 3; i++)
        thisDataSet.Tables.Add();
    Console.WriteLine(thisDataSet.Tables.Count.ToString()
        + " tables");
    foreach (DataTable table in thisDataSet.Tables)
        Console.WriteLine(table.TableName);
}

Private Sub AddTables()
   Dim table As DataTable
   
   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)
   Dim i As Integer
   For i = 0 to 2
      thisDataSet.Tables.Add()
   Next i

   Console.WriteLine(thisDataSet.Tables.Count.ToString() & " tables")
   For Each table In thisDataSet.Tables
      Console.WriteLine(table.TableName)
   Next
End Sub

Remarques

Étant donné qu’aucun nom n’est spécifié, le est créé à l’aide DataTable d’un nom par défaut, par rapport à son ordre d’ajout. Le nom par défaut est « Table1 ».

L’événement CollectionChanged se produit lorsqu’une table est correctement ajoutée à la collection.

Voir aussi

S’applique à

Add(DataTable)

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Ajoute l'objet DataTable spécifié à la collection.

public:
 void Add(System::Data::DataTable ^ table);

public:
 virtual void Add(System::Data::DataTable ^ table);

public void Add (System.Data.DataTable table);

public virtual void Add (System.Data.DataTable table);

member this.Add : System.Data.DataTable -> unit

abstract member Add : System.Data.DataTable -> unit
override this.Add : System.Data.DataTable -> unit

Public Sub Add (table As DataTable)

Public Overridable Sub Add (table As DataTable)

Paramètres

table: DataTable

Objet DataTable à ajouter.

Exceptions

ArgumentNullException

La valeur spécifiée pour la table est null.

ArgumentException

La table appartient déjà à cette collection ou à une autre collection.

DuplicateNameException

Une table de la collection porte le même nom. La comparaison ne respecte pas la casse.

Exemples

L’exemple suivant crée un DataTable et l’ajoute DataTableCollection au d’un DataSet.

private void AddDataTable()
{
    // Get the DataTableCollection of a DataGrid
    // control's DataSet.
    DataTableCollection tables =
        ((DataSet)DataGrid1.DataSource).Tables;

    // Create a new DataTable.
    DataTable table = new DataTable();

    // Code to add columns and rows not shown here.

    // Add the table to the DataTableCollection.
    tables.Add(table);
}

Remarques

L’événement CollectionChanged se produit lorsqu’une table est correctement ajoutée à la collection.

Voir aussi

S’applique à

Add(String)

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.

public:
 System::Data::DataTable ^ Add(System::String ^ name);

public:
 virtual System::Data::DataTable ^ Add(System::String ^ name);

public System.Data.DataTable Add (string? name);

public System.Data.DataTable Add (string name);

public virtual System.Data.DataTable Add (string name);

member this.Add : string -> System.Data.DataTable

abstract member Add : string -> System.Data.DataTable
override this.Add : string -> System.Data.DataTable

Public Function Add (name As String) As DataTable

Public Overridable Function Add (name As String) As DataTable

Paramètres

name: String

Nom à attribuer au DataTable créé.

Retours

DataTable

Objet DataTable nouvellement créé.

Exceptions

DuplicateNameException

Une table de la collection porte le même nom. (La comparaison ne respecte pas la casse.)

Exemples

L’exemple suivant ajoute un DataTable avec le nom donné au DataTableCollection.

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}

Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Remarques

null Si ou une chaîne vide (« ») est passée, un nom par défaut est donné au nouvellement créé DataTable. Ce nom est basé sur l’ordre dans lequel la table a été ajoutée (« Table1 », « Table2 », etc.).

L’événement CollectionChanged se produit si la table est correctement ajoutée à la collection.

Voir aussi

S’applique à

Add(String, String)

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Source:: DataTableCollection.cs

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::String ^ tableNamespace);

public System.Data.DataTable Add (string? name, string? tableNamespace);

public System.Data.DataTable Add (string name, string tableNamespace);

member this.Add : string * string -> System.Data.DataTable

Public Function Add (name As String, tableNamespace As String) As DataTable

Paramètres

name: String

Nom à attribuer au DataTable créé.

tableNamespace: String

Espace de noms auquel attribuer le DataTable créé.

Retours

DataTable

Objet DataTable nouvellement créé.

Exceptions

DuplicateNameException

Une table de la collection porte le même nom. (La comparaison ne respecte pas la casse.)

Exemples

L’exemple suivant ajoute un DataTable avec le nom donné au DataTableCollection.

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}

Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Remarques

L’événement CollectionChanged se produit si la table est correctement ajoutée à la collection.

Voir aussi

S’applique à

DataTableCollection.Add Méthode

Définition

Surcharges

Add()

Retours

Exemples

Remarques

Voir aussi

S’applique à

Add(DataTable)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Add(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Add(String, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Commentaires

Ressources supplémentaires