DataTableCollection.Add DataTableCollection.Add DataTableCollection.Add DataTableCollection.Add Method

Définition

Ajoute un objet DataTable à la collection.Adds a DataTable object to the collection.

Surcharges

Add() Add() Add() Add()

Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.Creates a new DataTable object by using a default name and adds it to the collection.

Add(DataTable) Add(DataTable) Add(DataTable) Add(DataTable)

Ajoute l'objet DataTable spécifié à la collection.Adds the specified DataTable to the collection.

Add(String) Add(String) Add(String) Add(String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

Add() Add() Add() Add()

Crée un nouvel objet DataTable avec un nom par défaut et l'ajoute à la collection.Creates a new DataTable object by using a default name and adds it to the collection.

public:
 System::Data::DataTable ^ Add();
public System.Data.DataTable Add ();
member this.Add : unit -> System.Data.DataTable
Public Function Add () As DataTable

Retours

Objet DataTable nouvellement créé.The newly created DataTable.

Exemples

L’exemple suivant ajoute trois nouveaux DataTable objets à l' DataTableCollection objet à Add l’aide de la méthode sans arguments.The following example adds three new DataTable objects to the DataTableCollection using the Add method without 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 DataTable spécifié, le est créé à l’aide d’un nom par défaut, par rapport à son ordre d’addition.Because no name is specified, the DataTable is created by using a default name, relative to its order of addition. Le nom par défaut est «table1».The default name is "Table1."

L' CollectionChanged événement se produit lorsqu’une table est correctement ajoutée à la collection.The CollectionChanged event occurs when a table is successfully added to the collection.

Voir aussi

Add(DataTable) Add(DataTable) Add(DataTable) Add(DataTable)

Ajoute l'objet DataTable spécifié à la collection.Adds the specified DataTable to the collection.

public:
 void Add(System::Data::DataTable ^ table);
public void Add (System.Data.DataTable table);
member this.Add : System.Data.DataTable -> unit
Public Sub Add (table As DataTable)

Paramètres

table
DataTable DataTable DataTable DataTable

Objet DataTable à ajouter.The DataTable object to add.

Exceptions

La valeur spécifiée pour la table est null.The value specified for the table is null.

La table appartient déjà à cette collection ou à une autre collection.The table already belongs to this collection, or belongs to another collection.

Une table de la collection porte le même nom.A table in the collection has the same name. La comparaison ne respecte pas la casse.The comparison is not case sensitive.

Exemples

L’exemple suivant crée un DataTable et l’ajoute à la DataTableCollection valeur de DataSet.The following example creates a DataTable and adds it to the DataTableCollection of a 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' CollectionChanged événement se produit lorsqu’une table est correctement ajoutée à la collection.The CollectionChanged event occurs when a table is successfully added to the collection.

Voir aussi

Add(String) Add(String) Add(String) Add(String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

public:
 System::Data::DataTable ^ Add(System::String ^ name);
public System.Data.DataTable Add (string name);
member this.Add : string -> System.Data.DataTable
Public Function Add (name As String) As DataTable

Paramètres

name
String String String String

Nom à attribuer au DataTable créé.The name to give the created DataTable.

Retours

Objet DataTable nouvellement créé.The newly created DataTable.

Exceptions

Une table de la collection porte le même nom.A table in the collection has the same name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

Exemples

L’exemple suivant ajoute un DataTable avec le nom donné DataTableCollectionau.The following example adds a DataTable with the given name to the 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

Si ou une chaîne vide ("") est passée, un nom par défaut est attribué au nouvellement créé DataTable. nullIf either null or an empty string ("") is passed in, a default name is given to the newly created DataTable. Ce nom est basé sur l’ordre dans lequel la table a été ajoutée («Table1», «Table2», etc.).This name is based on the order in which the table was added ("Table1", "Table2", and so on).

L' CollectionChanged événement se produit si la table est correctement ajoutée à la collection.The CollectionChanged event occurs if the table is successfully added to the collection.

Voir aussi

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Crée un objet DataTable en utilisant le nom spécifié et l'ajoute à la collection.Creates a DataTable object by using the specified name and adds it to the collection.

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::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 String String String

Nom à attribuer au DataTable créé.The name to give the created DataTable.

tableNamespace
String String String String

Espace de noms auquel attribuer le DataTable créé.The namespace to give the created DataTable.

Retours

Objet DataTable nouvellement créé.The newly created DataTable.

Exceptions

Une table de la collection porte le même nom.A table in the collection has the same name. (La comparaison ne respecte pas la casse.)(The comparison is not case sensitive.)

Exemples

L’exemple suivant ajoute un DataTable avec le nom donné DataTableCollectionau.The following example adds a DataTable with the given name to the 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

Si ou une chaîne vide ("") est passée, un nom par défaut est attribué au nouvellement créé DataTable. nullIf either null or an empty string ("") is passed in, a default name is given to the newly created DataTable. Ce nom est basé sur l’ordre dans lequel la table a été ajoutée («Table1», «Table2», etc.).This name is based on the order in which the table was added ("Table1", "Table2", and so on).

L' CollectionChanged événement se produit si la table est correctement ajoutée à la collection.The CollectionChanged event occurs if the table is successfully added to the collection.

Voir aussi

S’applique à