Freigeben über


DataTable Konstruktoren

Definition

Initialisiert eine neue Instanz der DataTable-Klasse.

Überlädt

Name Beschreibung
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 mithilfe des angegebenen Tabellennamens und Namespaces.

DataTable()

Quelle:
DataTable.cs
Quelle:
DataTable.cs
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

Das folgende Beispiel erstellt ein neues mit und zeigt es in einem Steuerelement an.The following example creates a new DataTable with DataColumn and DataRow, and displays it in a DataGridView control.

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 die Anfangswerte für alle Eigenschaften des DataTable Objekts fest. In der folgenden Tabelle sind die Eigenschaften und deren Standardwerte aufgeführt. Wenn eine Instanz erstellt DataTable wird, werden die folgenden Lese-/Schreibeigenschaften auf Anfangswerte festgelegt.

Eigentum Standardwert
CaseSensitive Identisch mit dem übergeordneten Element DataSet, wenn es zu einem gehört. Andernfalls, false.
DisplayExpression Leere Zeichenfolge ("")
Locale Identisch mit den übergeordneten DataSet Objekten (die von der Locale Eigenschaft zurückgegeben werden); wenn kein übergeordnetes Objekt CultureInfo vorhanden ist, ist die Standardeinstellung das aktuelle SystemCultureInfo.
MinimumCapacity 50 Zeilen.

Sie können den Wert für eine dieser Eigenschaften durch einen separaten Aufruf der Eigenschaft ändern.

Weitere Informationen

Gilt für:

DataTable(String)

Quelle:
DataTable.cs
Quelle:
DataTable.cs
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 zugewiesen werden soll. Wenn tableName es sich um eine leere Zeichenfolge handelt null , wird ein Standardname angegeben, wenn er der DataTableCollectionZeichenfolge hinzugefügt wird.

Beispiele

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

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
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);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
[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);
protected DataTable(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
protected DataTable(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
[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.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
[<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
new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
new System.Data.DataTable : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Data.DataTable
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
[<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

Kontextbezogene Informationen zum serialisierten Datenstrom.

Attribute

Ausnahmen

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

Hinweise

Diese Implementierung des DataTable Konstruktors ist erforderlich.ISerializable

Weitere Informationen

Gilt für:

DataTable(String, String)

Quelle:
DataTable.cs
Quelle:
DataTable.cs
Quelle:
DataTable.cs
Quelle:
DataTable.cs
Quelle:
DataTable.cs

Initialisiert eine neue Instanz der DataTable Klasse mithilfe des angegebenen Tabellennamens und Namespaces.

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 zugewiesen werden soll. Wenn tableName es sich um eine leere Zeichenfolge handelt null , wird ein Standardname angegeben, wenn er der DataTableCollectionZeichenfolge hinzugefügt wird.

tableNamespace
String

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

Weitere Informationen

Gilt für: