DataTableCollection.Add Método

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona um objeto de DataTable à coleção.

Sobrecargas

Add()	Cria um novo objeto DataTable usando um nome padrão e o adiciona à coleção.
Add(DataTable)	Adiciona o `DataTable` especificado à coleção.
Add(String)	Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.
Add(String, String)	Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.

Add()

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Cria um novo objeto DataTable usando um nome padrão e o adiciona à coleção.

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

Retornos

DataTable

O DataTable recém-criado.

Exemplos

O exemplo a seguir adiciona três novos DataTable objetos ao DataTableCollection usando o Add método sem 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

Comentários

Como nenhum nome é especificado, o DataTable é criado usando um nome padrão, em relação à ordem de adição. O nome padrão é "Table1".

O CollectionChanged evento ocorre quando uma tabela é adicionada com êxito à coleção.

Confira também

Aplica-se a

Add(DataTable)

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Adiciona o DataTable especificado à coleção.

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)

Parâmetros

table: DataTable

O objeto DataTable a ser adicionado.

Exceções

ArgumentNullException

O valor especificado para a tabela é null.

ArgumentException

A tabela já pertence a essa coleção ou a outra coleção.

DuplicateNameException

Uma tabela na coleção tem o mesmo nome. A comparação não diferencia maiúsculas de minúsculas.

Exemplos

O exemplo a seguir cria um DataTable e o adiciona ao DataTableCollection de um 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);
}

Comentários

O CollectionChanged evento ocorre quando uma tabela é adicionada com êxito à coleção.

Confira também

Aplica-se a

Add(String)

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.

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

Parâmetros

name: String

O nome a ser dado a DataTable criada.

Retornos

DataTable

O DataTable recém-criado.

Exceções

DuplicateNameException

Uma tabela na coleção tem o mesmo nome. (A comparação não diferencia maiúsculas de minúsculas.)

Exemplos

O exemplo a seguir adiciona um DataTable com o nome fornecido ao 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

Comentários

Se ou null uma cadeia de caracteres vazia ("") for passada, um nome padrão será fornecido ao recém-criado DataTable. Esse nome se baseia na ordem na qual a tabela foi adicionada ("Table1", "Table2" e assim por diante).

O CollectionChanged evento ocorrerá se a tabela for adicionada com êxito à coleção.

Confira também

Aplica-se a

Add(String, String)

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Origem:: DataTableCollection.cs

Cria um objeto DataTable usando o nome especificado e o adiciona à coleção.

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

Parâmetros

name: String

O nome a ser dado a DataTable criada.

tableNamespace: String

O namespace a ser dado a DataTable criada.

Retornos

DataTable

O DataTable recém-criado.

Exceções

DuplicateNameException

Uma tabela na coleção tem o mesmo nome. (A comparação não diferencia maiúsculas de minúsculas.)

Exemplos

O exemplo a seguir adiciona um DataTable com o nome fornecido ao 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

Comentários

O CollectionChanged evento ocorrerá se a tabela for adicionada com êxito à coleção.

Confira também

Aplica-se a

Partilhar via

DataTableCollection.Add Método

Definição

Sobrecargas

Add()

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

Add(DataTable)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Add(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Add(String, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais