DataTable Constructores

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Inicializa una nueva instancia de la clase DataTable.

Sobrecargas

Nombre	Description
DataTable()	Inicializa una nueva instancia de la DataTable clase sin argumentos.
DataTable(String)	Inicializa una nueva instancia de la DataTable clase con el nombre de tabla especificado.
DataTable(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la DataTable clase con datos serializados.
DataTable(String, String)	Inicializa una nueva instancia de la DataTable clase utilizando el nombre de tabla y el espacio de nombres especificados.

DataTable()

Source:

DataTable.cs

Inicializa una nueva instancia de la DataTable clase sin argumentos.

public:
 DataTable();

public DataTable();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea un nuevo DataTable con DataColumn y DataRowy , y se muestra en un 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

Comentarios

El constructor establece los valores iniciales de todas las propiedades del DataTable objeto . En la tabla siguiente se muestran las propiedades y sus valores predeterminados. Cuando se crea una instancia de , las siguientes propiedades de DataTable lectura y escritura se establecen en valores iniciales.

Propiedad	Valor predeterminado
CaseSensitive	Igual que el elemento primario DataSet, si pertenece a uno. En caso contrario, es false.
DisplayExpression	Cadena vacía ("")
Locale	Igual que el objeto CultureInfo primario (devuelto por la Locale propiedad ); si no existe ningún elemento primarioDataSet, el valor predeterminado es el sistema CultureInfoactual.
MinimumCapacity	50 filas.

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Consulte también

• DataTables

DataTable(String)

Source:

DataTable.cs

Inicializa una nueva instancia de la DataTable clase con el nombre de tabla especificado.

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

public DataTable(string? tableName);

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

Public Sub New (tableName As String)

Parámetros

tableName

String

Nombre que se va a asignar a la tabla. Si tableName es null o una cadena vacía, se proporciona un nombre predeterminado cuando se agrega a DataTableCollection.

Ejemplos

En el ejemplo siguiente se crea y DataTable se muestra en un DataGridView control .

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

Consulte también

• DataTables

DataTable(SerializationInfo, StreamingContext)

Source:

DataTable.cs

Precaución

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

Inicializa una nueva instancia de la DataTable clase con datos serializados.

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

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

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

Parámetros

info

SerializationInfo

Datos serializados para el conjunto de datos.

context

StreamingContext

Información contextual sobre la secuencia serializada.

Atributos

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute ObsoleteAttribute

Excepciones

InvalidEnumArgumentException

Solo .NET 7 y versiones posteriores: info contiene datos binarios.

Comentarios

Esta implementación del DataTable constructor es necesaria para ISerializable.

Consulte también

• DataTables

DataTable(String, String)

Source:

DataTable.cs

Inicializa una nueva instancia de la DataTable clase utilizando el nombre de tabla y el espacio de nombres especificados.

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)

Parámetros

tableName

String

Nombre que se va a asignar a la tabla. Si tableName es null o una cadena vacía, se proporciona un nombre predeterminado cuando se agrega a DataTableCollection.

tableNamespace

String

Espacio de nombres para la representación XML de los datos almacenados en DataTable.

Consulte también

• DataTables