DataTable Constructores

Definición

Inicializa una nueva instancia de la clase DataTable.

Sobrecargas

DataTable()

Inicializa una nueva instancia de la clase DataTable sin argumentos.

DataTable(String)

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

DataTable(SerializationInfo, StreamingContext)
Obsoletos.

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

DataTable(String, String)

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

DataTable()

Inicializa una nueva instancia de la clase DataTable sin argumentos.

public:
 DataTable();
public DataTable ();
Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea un nuevo DataTable con DataColumn y DataRow, 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 valores iniciales para 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 ("")
Configuración regional Igual que el del objeto primario DataSet (devuelto por la Locale propiedad); si no existe ningún elemento primario, el valor predeterminado es el sistema CultureInfoCultureInfo actual.
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

Se aplica a

DataTable(String)

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

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)

Parámetros

tableName
String

Nombre que se va a asignar a la tabla. Si tableName es null o una cadena vacía, se le asigna un nombre predeterminado al agregarlo a DataTableCollection.

Ejemplos

En el ejemplo siguiente se crea un DataTable objeto y 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

Se aplica a

DataTable(SerializationInfo, StreamingContext)

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 clase DataTable con datos serializados.

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)

Parámetros

info
SerializationInfo

Datos serializados para el conjunto de datos.

context
StreamingContext

Información contextual sobre la secuencia serializada.

Atributos

Excepciones

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

Comentarios

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

Consulte también

Se aplica a

DataTable(String, String)

Inicializa una nueva instancia de la clase DataTable 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);
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 le asigna un nombre predeterminado al agregarlo a DataTableCollection.

tableNamespace
String

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

Consulte también

Se aplica a