DataTable Konstruktoren

Referenz

Definition

Namespace:: System.Data

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.

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

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente.

public:
 DataTable();

public DataTable ();

Public Sub New ()

Beispiele

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

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

Private Sub MakeDataTableAndDisplay()
   ' Create new DataTable.
   Dim table As New DataTable

   ' Declare DataColumn and DataRow variables.
   Dim column As DataColumn
   Dim row As DataRow

   ' 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.    
   Dim i As Integer
   For i = 0 To 10
      row = table.NewRow
      row("id") = i
      row("item") = "item " & i
      table.Rows.Add(row)
   Next i

   ' Set to DataGrid.DataSource property to the table.
   DataGrid1.DataSource = table
End Sub

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 DataSet CultureInfo 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"

Gilt für:

DataTable(String)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

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

public:
 DataTable(System::String ^ tableName);

public DataTable (string? tableName);

public DataTable (string tableName);

new System.Data.DataTable : string -> System.Data.DataTable

Public Sub New (tableName As String)

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.

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

Private Sub MakeDataTableAndDisplay()
   ' Create new DataTable.
   Dim table As New DataTable("table")

   ' Declare DataColumn and DataRow variables.
   Dim column As DataColumn
   Dim row As DataRow

   ' 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.    
   Dim i As Integer
   For i = 0 To 10
      row = table.NewRow
      row("id") = i
      row("item") = "item " & i
      table.Rows.Add(row)
   Next i

   ' Set to DataGrid.DataSource property to the table.
   DataGrid1.DataSource = table
End Sub

Weitere Informationen

"DataTables"

Gilt für:

DataTable(SerializationInfo, StreamingContext)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

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.

protected:
 DataTable(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected DataTable (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

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

new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable

[<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}")>]
new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable

Protected Sub New (info As SerializationInfo, context As StreamingContext)

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"

Gilt für:

DataTable(String, String)

Quelle:: DataTable.cs

Quelle:: DataTable.cs

Quelle:: DataTable.cs

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

public:
 DataTable(System::String ^ tableName, System::String ^ tableNamespace);

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

public DataTable (string tableName, string tableNamespace);

new System.Data.DataTable : string * string -> System.Data.DataTable

Public Sub New (tableName As String, tableNamespace As String)

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"

Gilt für:

Freigeben über

DataTable Konstruktoren

Definition

Überlädt

DataTable()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DataTable(String)

Parameter

Beispiele

Weitere Informationen

Gilt für:

DataTable(SerializationInfo, StreamingContext)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

DataTable(String, String)

Parameter

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen