DataTableCollection.Add Méthode

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

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

public virtual System.Data.DataTable Add();

public System.Data.DataTable Add();

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

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

Public Overridable Function Add () As DataTable

Public Function Add () As DataTable

Retours

Nouvellement créé DataTable.

Exemples

L’exemple suivant ajoute trois nouveaux DataTable objets à l’utilisation 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

Comme aucun nom n’est spécifié, il DataTable est créé à l’aide 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

• DataTable
• Remove(DataTable)
• Clear()

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

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

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

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

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

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

Public Overridable Sub Add (table As DataTable)

Public Sub Add (table As DataTable)

Paramètres

Exceptions

Exemples

L’exemple suivant crée un DataTable élément et l’ajoute à l’objet DataTableCollectionDataSet.

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

• DataTable
• Remove(DataTable)
• Clear()

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

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

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

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

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

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

Public Overridable Function Add (name As String) As DataTable

Public Function Add (name As String) As DataTable

Paramètres

Retours

Nouvellement créé DataTable.

Exceptions

Exemples

L’exemple suivant ajoute un DataTable nom donné au DataTableCollectionfichier .

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 l’une null ou l’autre chaîne vide («  ») est passée, un nom par défaut est attribué à la nouvelle chaîne créée 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

• DataTable
• Remove(DataTable)
• Clear()

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

Retours

Nouvellement créé DataTable.

Exceptions

Exemples

L’exemple suivant ajoute un DataTable nom donné au DataTableCollectionfichier .

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 l’une null ou l’autre chaîne vide («  ») est passée, un nom par défaut est attribué à la nouvelle chaîne créée 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

• DataTable
• Remove(DataTable)
• Clear()