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.

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 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.

public:
 DataTable(System::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"

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.

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

[<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"

DataTable(String, String)

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

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"