Sdílet prostřednictvím


DataTableCollection.Add Metoda

Definice

DataTable Přidá objekt do kolekce.

Přetížení

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)

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

Add(String, String)

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

Add()

Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs
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:
 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

Návraty

Nově vytvořená položka DataTable.

Příklady

Následující příklad přidá tři nové DataTable objekty pomocí DataTableCollectionAdd metody 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".

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

Viz také

Platí pro

Add(DataTable)

Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs

Přidá zadaný DataTable objekt do kolekce.

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)

Parametry

table
DataTable

Objekt DataTable , který chcete přidat.

Výjimky

Hodnota zadaná pro tabulku je null.

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

Tabulka v kolekci má stejný název. Při porovnání se nerozlišuje velká a malá písmena.

Příklady

Následující příklad vytvoří DataTable a přidá ho 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

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

Viz také

Platí pro

Add(String)

Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs

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

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

Parametry

name
String

Název, který má dát vytvořenému DataTableobjektu .

Návraty

Nově vytvořená položka DataTable.

Výjimky

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

Příklady

Následující příklad přidá do DataTable souboru hodnotu se zadaným DataTableCollectionnázvem .

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á jeden null nebo prázdný řetězec (""), bude nově vytvořenému DataTableobjektu přiřazen výchozí název . Tento název je založen na pořadí, ve kterém byla tabulka přidána (Tabulka1, Tabulka2 atd.).

K CollectionChanged této události dojde, pokud je tabulka úspěšně přidána do kolekce.

Viz také

Platí pro

Add(String, String)

Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs
Zdroj:
DataTableCollection.cs

Vytvoří DataTable 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);
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á dát vytvořenému DataTableobjektu .

tableNamespace
String

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

Návraty

Nově vytvořená položka DataTable.

Výjimky

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

Příklady

Následující příklad přidá do DataTable souboru hodnotu se zadaným DataTableCollectionnázvem .

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á jeden null nebo prázdný řetězec (""), bude nově vytvořenému DataTableobjektu přiřazen výchozí název . Tento název je založen na pořadí, ve kterém byla tabulka přidána (Tabulka1, Tabulka2 atd.).

K CollectionChanged této události dojde, pokud je tabulka úspěšně přidána do kolekce.

Viz také

Platí pro