DataTable Costruttori

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Inizializza una nuova istanza della classe DataTable.

Overload

DataTable()	Inizializza una nuova istanza della classe DataTable senza argomenti.
DataTable(String)	Inizializza una nuova istanza della classe DataTable con il nome della tabella specificato.
DataTable(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della classe DataTable con dati serializzati.
DataTable(String, String)	Inizializza una nuova istanza della classe DataTable con il nome della tabella e lo spazio dei nomi specificati.

DataTable()

Origine:

DataTable.cs

Inizializza una nuova istanza della classe DataTable senza argomenti.

public:
 DataTable();

public DataTable ();

Public Sub New ()

Esempio

Nell'esempio seguente viene creato un nuovo DataTable oggetto con DataColumn e DataRowe viene visualizzato in un DataGridView controllo.

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

Commenti

Il costruttore imposta i valori iniziali per tutte le proprietà dell'oggetto DataTable . La tabella seguente mostra le proprietà e i relativi valori predefiniti. Quando viene creata un'istanza di, le proprietà di DataTable lettura/scrittura seguenti vengono impostate sui valori iniziali.

Proprietà	Valore predefinito
CaseSensitive	Uguale a quello padre DataSet, se appartiene a uno. In caso contrario, false.
DisplayExpression	Stringa vuota ("")
Impostazioni locali	Uguale a quello dell'oggetto CultureInfo padre (restituito dalla Locale proprietà); se non esiste alcun elemento padreDataSet, il valore predefinito è il sistema CultureInfocorrente.
MinimumCapacity	50 righe.

È possibile modificare il valore per una di queste proprietà tramite una chiamata separata alla proprietà.

Vedi anche

• DataTables

DataTable(String)

Origine:

DataTable.cs

Inizializza una nuova istanza della classe DataTable con il nome della tabella specificato.

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

public DataTable (string? tableName);

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

Public Sub New (tableName As String)

Parametri

tableName

String

Nome da assegnare alla tabella. Se tableName è impostato su null o su una stringa vuota, viene assegnato un nome predefinito nel momento in cui viene aggiunto all'insieme DataTableCollection.

Esempio

L'esempio seguente crea un oggetto DataTable e lo visualizza in un DataGridView controllo.

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

Vedi anche

• DataTables

DataTable(SerializationInfo, StreamingContext)

Origine:

DataTable.cs

Attenzione

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

Inizializza una nuova istanza della classe DataTable con dati serializzati.

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)

Parametri

info

SerializationInfo

Dati serializzati per il set di dati.

context

StreamingContext

Informazioni contestuali sul flusso serializzato.

Attributi

ObsoleteAttribute

Eccezioni

InvalidEnumArgumentException

Solo .NET 7 e versioni successive: info contiene dati binari.

Commenti

Questa implementazione del DataTable costruttore è necessaria per ISerializable.

Vedi anche

• DataTables

DataTable(String, String)

Origine:

DataTable.cs

Inizializza una nuova istanza della classe DataTable con il nome della tabella e lo spazio dei nomi specificati.

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)

Parametri

tableName

String

Nome da assegnare alla tabella. Se tableName è impostato su null o su una stringa vuota, viene assegnato un nome predefinito nel momento in cui viene aggiunto all'insieme DataTableCollection.

tableNamespace

String

Spazio dei nomi della rappresentazione XML dei dati memorizzati nella classe DataTable.

Vedi anche

• DataTables