DataTableCollection.Add Methode

Definition

Namespace:: System.Data

Assemblys:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Auflistung ein DataTable Objekt hinzu.

Überlädt

Name	Beschreibung
Add()	Erstellt ein neues DataTable Objekt mithilfe eines Standardnamens und fügt es der Auflistung hinzu.
Add(DataTable)	Fügt der Auflistung den angegebenen `DataTable` Wert hinzu.
Add(String)	Erstellt ein DataTable Objekt mithilfe des angegebenen Namens und fügt es der Auflistung hinzu.
Add(String, String)	Erstellt ein DataTable Objekt mithilfe des angegebenen Namens und fügt es der Auflistung hinzu.

Add()

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Erstellt ein neues DataTable Objekt mithilfe eines Standardnamens 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

DataTable

Die neu erstellte DataTable.

Beispiele

Im folgenden Beispiel werden der DataTable Verwendung der DataTableCollection Methode ohne Argumente drei neue Add 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 ist, wird die DataTable Erstellung mithilfe eines Standardnamens relativ zur Reihenfolge der Hinzufügung erstellt. Der Standardname lautet "Tabelle1".

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

Weitere Informationen

Gilt für:

Add(DataTable)

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Fügt der Auflistung den angegebenen DataTable Wert 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 DataTable hinzuzufügende Objekt.

Ausnahmen

ArgumentNullException

Der für die Tabelle angegebene Wert ist null.

ArgumentException

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

DuplicateNameException

Eine Tabelle in der Auflistung hat denselben Namen. Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.

Beispiele

Im folgenden Beispiel wird ein DataTable Objekt erstellt und dem DataTableCollection Von - DataSetObjekt hinzugefü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 wird.

Weitere Informationen

Gilt für:

Add(String)

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Erstellt ein DataTable Objekt mithilfe des angegebenen Namens 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, der der erstellten Datei DataTablezugewiesen werden soll.

Gibt zurück

DataTable

Die neu erstellte DataTable.

Ausnahmen

DuplicateNameException

Eine Tabelle in der Auflistung hat denselben Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

Beispiele

Im folgenden Beispiel wird DataTable dem Angegebenen Namen ein DataTableCollectionMitname hinzugefügt.

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 eine 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 ("Tabelle1", "Tabelle2" usw.).

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

Weitere Informationen

Gilt für:

Add(String, String)

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Quelle:: DataTableCollection.cs

Erstellt ein DataTable Objekt mithilfe des angegebenen Namens 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, der der erstellten Datei DataTablezugewiesen werden soll.

tableNamespace: String

Der Namespace, der dem erstellten DataTableNamespace zugewiesen werden soll.

Gibt zurück

DataTable

Die neu erstellte DataTable.

Ausnahmen

DuplicateNameException

Eine Tabelle in der Auflistung hat denselben Namen. (Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.)

Beispiele

Im folgenden Beispiel wird DataTable dem Angegebenen Namen ein DataTableCollectionMitname hinzugefügt.

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

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?