DataTableCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

DataTable Dodaje obiekt do kolekcji.

Przeciążenia

Add()	Tworzy nowy DataTable obiekt przy użyciu nazwy domyślnej i dodaje go do kolekcji.
Add(DataTable)	Dodaje określony DataTable element do kolekcji.
Add(String)	DataTable Tworzy obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.
Add(String, String)	DataTable Tworzy obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.

Add()

Źródło:

DataTableCollection.cs

Tworzy nowy DataTable obiekt przy użyciu nazwy domyślnej i dodaje go do kolekcji.

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

public System.Data.DataTable Add ();

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

Public Function Add () As DataTable

Zwraca

DataTable

Nowo utworzony element DataTable.

Przykłady

W poniższym przykładzie dodano trzy nowe DataTable obiekty do DataTableCollection metody bez Add argumentów.

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

Uwagi

Ponieważ żadna nazwa nie jest określona, DataTable element jest tworzony przy użyciu nazwy domyślnej względem jej kolejności dodawania. Domyślna nazwa to "Table1".

Zdarzenie CollectionChanged występuje, gdy tabela zostanie pomyślnie dodana do kolekcji.

Zobacz też

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Źródło:

DataTableCollection.cs

Dodaje określony DataTable element do kolekcji.

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

Obiekt do dodania DataTable .

Wyjątki

ArgumentNullException

Wartość określona dla tabeli to null.

ArgumentException

Tabela należy już do tej kolekcji lub należy do innej kolekcji.

DuplicateNameException

Tabela w kolekcji ma taką samą nazwę. W porównaniu nie jest uwzględniana wielkość liter.

Przykłady

Poniższy przykład tworzy obiekt DataTable i dodaje go do DataTableCollection obiektu 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);
}

Uwagi

Zdarzenie CollectionChanged występuje, gdy tabela zostanie pomyślnie dodana do kolekcji.

Zobacz też

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Źródło:

DataTableCollection.cs

DataTable Tworzy obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.

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

Nazwa, która ma nadać utworzony DataTableelement .

Zwraca

DataTable

Nowo utworzony element DataTable.

Wyjątki

DuplicateNameException

Tabela w kolekcji ma taką samą nazwę. (Porównanie nie uwzględnia wielkości liter).

Przykłady

Poniższy przykład dodaje element DataTable o podanej nazwie do elementu 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

Uwagi

null Jeśli zostanie przekazany pusty ciąg (""), do nowo utworzonej DataTablenazwy zostanie nadana nazwa domyślna . Ta nazwa jest oparta na kolejności dodawania tabeli ("Tabela1", "Tabela2" itd.).

Zdarzenie CollectionChanged występuje, jeśli tabela została pomyślnie dodana do kolekcji.

Zobacz też

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Źródło:

DataTableCollection.cs

DataTable Tworzy obiekt przy użyciu określonej nazwy i dodaje go do kolekcji.

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

Nazwa, która ma nadać utworzony DataTableelement .

tableNamespace

String

Przestrzeń nazw do nadania utworzonemu DataTableelementowi .

Zwraca

DataTable

Nowo utworzony element DataTable.

Wyjątki

DuplicateNameException

Tabela w kolekcji ma taką samą nazwę. (Porównanie nie uwzględnia wielkości liter).

Przykłady

Poniższy przykład dodaje element DataTable o podanej nazwie do elementu 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

Uwagi

null Jeśli zostanie przekazany pusty ciąg (""), do nowo utworzonej DataTablenazwy zostanie nadana nazwa domyślna . Ta nazwa jest oparta na kolejności dodawania tabeli ("Tabela1", "Tabela2" itd.).

Zdarzenie CollectionChanged występuje, jeśli tabela została pomyślnie dodana do kolekcji.

Zobacz też

• DataTable
• Remove(DataTable)
• Clear()