DataTableCollection.Add Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Agrega un objeto DataTable a la colección.

Sobrecargas

Add()	Crea un nuevo objeto DataTable utilizando un nombre predeterminado y lo agrega a la colección.
Add(DataTable)	Agrega el DataTable especificado a la colección.
Add(String)	Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.
Add(String, String)	Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.

Add()

Source:

DataTableCollection.cs

Crea un nuevo objeto DataTable utilizando un nombre predeterminado y lo agrega a la colección.

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

public System.Data.DataTable Add ();

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

Public Function Add () As DataTable

Devoluciones

DataTable

Colección DataTable creada recientemente.

Ejemplos

En el ejemplo siguiente se agregan tres nuevos DataTable objetos al DataTableCollection uso del Add método sin argumentos.

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

Comentarios

Dado que no se especifica ningún nombre, DataTable se crea mediante un nombre predeterminado, en relación con su orden de suma. El nombre predeterminado es "Table1".

El CollectionChanged evento se produce cuando una tabla se agrega correctamente a la colección.

Consulte también

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Source:

DataTableCollection.cs

Agrega el DataTable especificado a la colección.

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)

Parámetros

table

DataTable

Objeto DataTable que se agrega.

Excepciones

ArgumentNullException

El valor especificado para la tabla es null.

ArgumentException

La tabla ya pertenece a esta colección o pertenece a otra colección.

DuplicateNameException

Una tabla de la colección tiene el mismo nombre. La comparación no distingue entre mayúsculas y minúsculas.

Ejemplos

En el ejemplo siguiente se crea un DataTable objeto y se agrega a de DataTableCollection .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);
}

Comentarios

El CollectionChanged evento se produce cuando una tabla se agrega correctamente a la colección.

Consulte también

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Source:

DataTableCollection.cs

Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.

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

Parámetros

name

String

Nombre que se va a asignar al DataTable creado.

Devoluciones

DataTable

Colección DataTable creada recientemente.

Excepciones

DuplicateNameException

Una tabla de la colección tiene el mismo nombre. La comparación no distingue entre mayúsculas y minúsculas.

Ejemplos

En el ejemplo siguiente se agrega un DataTable con el nombre especificado a 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

Comentarios

Si se pasa una null cadena vacía (""), se asigna un nombre predeterminado al objeto recién creado DataTable. Este nombre se basa en el orden en que se agregó la tabla ("Table1", "Table2", etc.).

El CollectionChanged evento se produce si la tabla se agrega correctamente a la colección.

Consulte también

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Source:

DataTableCollection.cs

Crea un objeto DataTable utilizando el nombre especificado y lo agrega a la colección.

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

Parámetros

name

String

Nombre que se va a asignar al DataTable creado.

tableNamespace

String

Espacio de nombres que se va a asignar al objeto DataTable creado.

Devoluciones

DataTable

Colección DataTable creada recientemente.

Excepciones

DuplicateNameException

Una tabla de la colección tiene el mismo nombre. La comparación no distingue entre mayúsculas y minúsculas.

Ejemplos

En el ejemplo siguiente se agrega un DataTable con el nombre especificado a 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

Comentarios

Si se pasa una null cadena vacía (""), se asigna un nombre predeterminado al objeto recién creado DataTable. Este nombre se basa en el orden en que se agregó la tabla ("Table1", "Table2", etc.).

El CollectionChanged evento se produce si la tabla se agrega correctamente a la colección.

Consulte también

• DataTable
• Remove(DataTable)
• Clear()