DataTableCollection.Add Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Objektumot DataTable ad hozzá a gyűjteményhez.

Túlterhelések

Name	Description
Add()	Létrehoz egy új DataTable objektumot egy alapértelmezett névvel, és hozzáadja azt a gyűjteményhez.
Add(DataTable)	Hozzáadja a megadottt DataTable a gyűjteményhez.
Add(String)	Létrehoz egy DataTable objektumot a megadott névvel, és hozzáadja a gyűjteményhez.
Add(String, String)	Létrehoz egy DataTable objektumot a megadott névvel, és hozzáadja a gyűjteményhez.

Add()

Forrás:

DataTableCollection.cs

Létrehoz egy új DataTable objektumot egy alapértelmezett névvel, és hozzáadja azt a gyűjteményhez.

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

public System.Data.DataTable Add();

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

Public Function Add () As DataTable

Válaszok

DataTable

Az újonnan létrehozott DataTable.

Példák

Az alábbi példa három új DataTable objektumot ad hozzá a DataTableCollectionAdd metódus argumentumok nélküli használatához.

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

Megjegyzések

Mivel nincs megadva név, a DataTable rendszer az alapértelmezett névvel hozza létre a hozzáadási sorrendhez képest. Az alapértelmezett név a "Table1".

Az CollectionChanged esemény akkor következik be, ha a rendszer sikeresen hozzáad egy táblát a gyűjteményhez.

Lásd még

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Forrás:

DataTableCollection.cs

Hozzáadja a megadottt DataTable a gyűjteményhez.

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)

Paraméterek

table

DataTable

A DataTable hozzáadni kívánt objektum.

Kivételek

ArgumentNullException

A táblához megadott érték a következő null: .

ArgumentException

A tábla már ebbe a gyűjteménybe tartozik, vagy egy másik gyűjteményhez tartozik.

DuplicateNameException

A gyűjtemény egyik táblájának ugyanaz a neve. Az összehasonlítás nem érzékeny a kis- és nagybetűkre.

Példák

Az alábbi példa létrehoz egy DataTable elemet, és hozzáadja azt egy DataTableCollectionDataSetfájlhoz.

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);
}

Megjegyzések

Az CollectionChanged esemény akkor következik be, ha a rendszer sikeresen hozzáad egy táblát a gyűjteményhez.

Lásd még

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Forrás:

DataTableCollection.cs

Létrehoz egy DataTable objektumot a megadott névvel, és hozzáadja a gyűjteményhez.

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

Paraméterek

name

String

A létrehozott DataTablenév.

Válaszok

DataTable

Az újonnan létrehozott DataTable.

Kivételek

DuplicateNameException

A gyűjtemény egyik táblájának ugyanaz a neve. (Az összehasonlítás nem megkülönbözteti a kis- és nagybetűk különbségét.)

Példák

Az alábbi példa egy DataTable utónevet ad hozzá 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

Megjegyzések

Ha vagy null egy üres sztring ("") van átadva, a rendszer alapértelmezett nevet ad az újonnan létrehozottnak DataTable. Ez a név a tábla hozzáadásának sorrendjén alapul ("Table1", "Table2" stb.).

Az CollectionChanged esemény akkor következik be, ha a tábla sikeresen hozzá van adva a gyűjteményhez.

Lásd még

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Forrás:

DataTableCollection.cs

Létrehoz egy DataTable objektumot a megadott névvel, és hozzáadja a gyűjteményhez.

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éterek

name

String

A létrehozott DataTablenév.

tableNamespace

String

A létrehozott DataTablenévtér.

Válaszok

DataTable

Az újonnan létrehozott DataTable.

Kivételek

DuplicateNameException

A gyűjtemény egyik táblájának ugyanaz a neve. (Az összehasonlítás nem megkülönbözteti a kis- és nagybetűk különbségét.)

Példák

Az alábbi példa egy DataTable utónevet ad hozzá 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

Megjegyzések

Ha vagy null egy üres sztring ("") van átadva, a rendszer alapértelmezett nevet ad az újonnan létrehozottnak DataTable. Ez a név a tábla hozzáadásának sorrendjén alapul ("Table1", "Table2" stb.).

Az CollectionChanged esemény akkor következik be, ha a tábla sikeresen hozzá van adva a gyűjteményhez.

Lásd még

• DataTable
• Remove(DataTable)
• Clear()