Freigeben über


DataTableCollection.Add Methode

Definition

Fügt der Auflistung ein DataTable-Objekt hinzu.

Überlädt

Add()

Erstellt ein neues DataTable-Objekt mit einem Standardnamen und fügt es der Auflistung hinzu.

Add(DataTable)

Fügt der Auflistung den angegebenen DataTable hinzu.

Add(String)

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.

Add(String, String)

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.

Add()

Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs

Erstellt ein neues DataTable-Objekt mit einem Standardnamen und fügt es der Auflistung hinzu.

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

Gibt zurück

Der neu erstellte DataTable.

Beispiele

Im folgenden Beispiel werden mithilfe der DataTableCollectionAdd -Methode ohne Argumente drei neue DataTable Objekte hinzugefügt.

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

Hinweise

Da kein Name angegeben wird, wird der DataTable mithilfe eines Standardnamens relativ zur Reihenfolge der Addition erstellt. Der Standardname ist "Table1".

Das CollectionChanged Ereignis tritt auf, wenn der Auflistung erfolgreich eine Tabelle hinzugefügt wurde.

Weitere Informationen

Gilt für:

Add(DataTable)

Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs

Fügt der Auflistung den angegebenen DataTable hinzu.

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)

Parameter

table
DataTable

Das hinzuzufügende DataTable-Objekt.

Ausnahmen

Der für die Tabelle angegebene Wert ist null.

Die Tabelle gehört bereits zu dieser Auflistung, oder sie gehört zu einer anderen Auflistung.

Eine Tabelle in der Auflistung hat bereits denselben Namen. Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.

Beispiele

Im folgenden Beispiel wird ein DataTable erstellt und dem DataTableCollection eines DataSethinzugefügt.

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

Hinweise

Das CollectionChanged Ereignis tritt auf, wenn der Auflistung erfolgreich eine Tabelle hinzugefügt wurde.

Weitere Informationen

Gilt für:

Add(String)

Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.

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

Parameter

name
String

Der Name, den die erstellte DataTable erhalten soll.

Gibt zurück

Der neu erstellte DataTable.

Ausnahmen

Eine Tabelle in der Auflistung hat bereits denselben Namen. (Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.)

Beispiele

Im folgenden Beispiel wird ein DataTable mit dem angegebenen Namen hinzugefügt 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

Hinweise

Wenn entweder null oder eine leere Zeichenfolge ("") übergeben wird, wird dem neu erstellten DataTableein Standardname zugewiesen. Dieser Name basiert auf der Reihenfolge, in der die Tabelle hinzugefügt wurde ("Table1", "Table2" usw.).

Das CollectionChanged Ereignis tritt auf, wenn die Tabelle erfolgreich der Auflistung hinzugefügt wurde.

Weitere Informationen

Gilt für:

Add(String, String)

Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs
Quelle:
DataTableCollection.cs

Erstellt ein DataTable-Objekt mit dem angegebenen Namen und fügt es der Auflistung hinzu.

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

Parameter

name
String

Der Name, den die erstellte DataTable erhalten soll.

tableNamespace
String

Der Namespace, den die erstellte DataTable erhalten soll.

Gibt zurück

Der neu erstellte DataTable.

Ausnahmen

Eine Tabelle in der Auflistung hat bereits denselben Namen. (Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.)

Beispiele

Im folgenden Beispiel wird ein DataTable mit dem angegebenen Namen hinzugefügt 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

Hinweise

Wenn entweder null oder eine leere Zeichenfolge ("") übergeben wird, wird dem neu erstellten DataTableein Standardname zugewiesen. Dieser Name basiert auf der Reihenfolge, in der die Tabelle hinzugefügt wurde ("Table1", "Table2" usw.).

Das CollectionChanged Ereignis tritt auf, wenn die Tabelle erfolgreich der Auflistung hinzugefügt wurde.

Weitere Informationen

Gilt für: