DataTable Konstruktoren

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Initialisiert eine neue Instanz der DataTable-Klasse.

Überlädt

DataTable()	Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente.
DataTable(String)	Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen.
DataTable(SerializationInfo, StreamingContext)	Veraltet. Initialisiert eine neue Instanz der DataTable-Klasse mit serialisierten Daten.
DataTable(String, String)	Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen und Namespace.

DataTable()

Quelle:

DataTable.cs

Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente.

C#

public DataTable ();

Beispiele

Im folgenden Beispiel wird eine neue DataTable mit DataColumn und DataRowerstellt und in einem DataGridView -Steuerelement angezeigt.

C#

private void MakeDataTableAndDisplay()
{
    // Create new DataTable.
    DataTable table = new DataTable();

    // Declare DataColumn and DataRow variables.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType, ColumnName
    // and add to DataTable.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = Type.GetType("System.String");
    column.ColumnName = "item";
    table.Columns.Add(column);

    // Create new DataRow objects and add to DataTable.
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }
    // Set to DataGrid.DataSource property to the table.
    dataGrid1.DataSource = table;
}

Hinweise

Der Konstruktor legt Anfangswerte für alle Eigenschaften des DataTable Objekts fest. Die folgende Tabelle zeigt die Eigenschaften und ihre Standardwerte. Wenn ein instance von DataTable erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf Anfangswerte festgelegt.

Eigenschaft	Standardwert
CaseSensitive	Identisch mit dem übergeordneten DataSet, wenn es zu einem gehört. Andernfalls false.
DisplayExpression	Leere Zeichenfolge ("")
Gebietsschema	Identisch mit dem übergeordneten DataSetCultureInfo Objekt (von der Locale -Eigenschaft zurückgegeben). Wenn kein übergeordnetes Objekt vorhanden ist, ist der Standardwert das aktuelle System CultureInfo.
MinimumCapacity	50 Zeilen.

Sie können den Wert für jede dieser Eigenschaften über einen separaten Aufruf der -Eigenschaft ändern.

Weitere Informationen

• "DataTables"

DataTable(String)

Quelle:

DataTable.cs

Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen.

C#

public DataTable (string? tableName);

Parameter

tableName

String

Der Name, der der Tabelle gegeben werden soll. Wenn tableNamenull oder eine leere Zeichenfolge ist, wird beim Hinzufügen zur DataTableCollection ein Standardname vergeben.

Beispiele

Im folgenden Beispiel wird ein DataTable erstellt und in einem DataGridView Steuerelement angezeigt.

C#

private void MakeDataTableAndDisplay()
{
    // Create new DataTable.
    DataTable table = new DataTable("table");

    // Declare DataColumn and DataRow variables.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType,
    // ColumnName and add to DataTable.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = Type.GetType("System.String");
    column.ColumnName = "item";
    table.Columns.Add(column);

    // Create new DataRow objects and add to DataTable.
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }
    // Set to DataGrid.DataSource property to the table.
    dataGrid1.DataSource = table;
}

Weitere Informationen

• "DataTables"

DataTable(SerializationInfo, StreamingContext)

Quelle:

DataTable.cs

Achtung

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initialisiert eine neue Instanz der DataTable-Klasse mit serialisierten Daten.

C#

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected DataTable (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

Parameter

info

SerializationInfo

Die serialisierten Daten für das Dataset.

context

StreamingContext

Kontextinformationen zum serialisierten Stream.

Attribute

ObsoleteAttribute

Ausnahmen

InvalidEnumArgumentException

Nur .NET 7 und höhere Versionen: info enthält Binärdaten.

Hinweise

Diese Implementierung des DataTable Konstruktors ist für ISerializableerforderlich.

Weitere Informationen

• "DataTables"

DataTable(String, String)

Quelle:

DataTable.cs

Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen und Namespace.

C#

public DataTable (string? tableName, string? tableNamespace);

Parameter

tableName

String

Der Name, der der Tabelle gegeben werden soll. Wenn tableNamenull oder eine leere Zeichenfolge ist, wird beim Hinzufügen zur DataTableCollection ein Standardname vergeben.

tableNamespace

String

Der Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten.

Weitere Informationen

• "DataTables"