DataTableCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

DataTable Přidá objekt do kolekce.

Přetížení

Name	Description
Add()	Vytvoří nový DataTable objekt pomocí výchozího názvu a přidá ho do kolekce.
Add(DataTable)	Přidá zadaný DataTable objekt do kolekce.
Add(String)	DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce.
Add(String, String)	DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce.

Add()

Zdroj:

DataTableCollection.cs

Vytvoří nový DataTable objekt pomocí výchozího názvu a přidá ho do kolekce.

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

public System.Data.DataTable Add();

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

Public Function Add () As DataTable

Návraty

DataTable

Nově vytvořený DataTable.

Příklady

Následující příklad přidá do DataTable metody pomocí DataTableCollection metody tři nové Add objekty bez argumentů.

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

Poznámky

Vzhledem k tomu, že není zadán žádný název, DataTable vytvoří se pomocí výchozího názvu vzhledem k jeho pořadí sčítání. Výchozí název je Tabulka1.

K CollectionChanged události dojde, když se do kolekce úspěšně přidá tabulka.

Viz také

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Zdroj:

DataTableCollection.cs

Přidá zadaný DataTable objekt do kolekce.

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)

Parametry

table

DataTable

Objekt DataTable , který chcete přidat.

Výjimky

ArgumentNullException

Hodnota zadaná pro tabulku je null.

ArgumentException

Tabulka již patří do této kolekce nebo patří do jiné kolekce.

DuplicateNameException

Tabulka v kolekci má stejný název. Porovnání nerozlišuje malá a velká písmena.

Příklady

Následující příklad vytvoří DataTable a přidá jej do DataTableCollection souboru 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);
}

Poznámky

K CollectionChanged události dojde, když se do kolekce úspěšně přidá tabulka.

Viz také

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Zdroj:

DataTableCollection.cs

DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce.

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

Parametry

name

String

Název, který má být vytvořen DataTable.

Návraty

DataTable

Nově vytvořený DataTable.

Výjimky

DuplicateNameException

Tabulka v kolekci má stejný název. (Porovnání nerozlišuje malá a velká písmena.)

Příklady

Následující příklad přidá s daným DataTable názvem do souboru 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

Poznámky

Pokud se předá buď null prázdný řetězec (""), bude nově vytvořenýmu nově vytvořenému DataTablenázvu přiřazen výchozí název . Tento název vychází z pořadí, ve kterém byla tabulka přidána (Tabulka1, Tabulka2 atd.).

Událost CollectionChanged nastane, pokud je tabulka úspěšně přidána do kolekce.

Viz také

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Zdroj:

DataTableCollection.cs

DataTable Vytvoří objekt pomocí zadaného názvu a přidá ho do kolekce.

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

Parametry

name

String

Název, který má být vytvořen DataTable.

tableNamespace

String

Obor názvů, který má dát vytvořenému DataTable.

Návraty

DataTable

Nově vytvořený DataTable.

Výjimky

DuplicateNameException

Tabulka v kolekci má stejný název. (Porovnání nerozlišuje malá a velká písmena.)

Příklady

Následující příklad přidá s daným DataTable názvem do souboru 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

Poznámky

Pokud se předá buď null prázdný řetězec (""), bude nově vytvořenýmu nově vytvořenému DataTablenázvu přiřazen výchozí název . Tento název vychází z pořadí, ve kterém byla tabulka přidána (Tabulka1, Tabulka2 atd.).

Událost CollectionChanged nastane, pokud je tabulka úspěšně přidána do kolekce.

Viz také

• DataTable
• Remove(DataTable)
• Clear()