Teilen über


DataTable Konstruktoren

Definition

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

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

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

Ausnahmen

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

Hinweise

Diese Implementierung des DataTable Konstruktors ist für ISerializableerforderlich.

Weitere Informationen

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

Gilt für: