DataTable Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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()
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- Source:
- DataTable.cs
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)
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- Source:
- DataTable.cs
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)
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- 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 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)
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- Source:
- DataTable.cs
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
.