DataTable DataTable DataTable DataTable Constructors

Definición

Sobrecargas

DataTable() DataTable() DataTable()

Inicializa una nueva instancia de la clase DataTable sin argumentos.Initializes a new instance of the DataTable class with no arguments.

DataTable(String) DataTable(String) DataTable(String) DataTable(String)

Inicializa una nueva instancia de la clase DataTable con el nombre de tabla especificado.Initializes a new instance of the DataTable class with the specified table name.

DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase DataTable con el objeto SerializationInfo y la estructura StreamingContext.Initializes a new instance of the DataTable class with the SerializationInfo and the StreamingContext.

DataTable(String, String) DataTable(String, String) DataTable(String, String) DataTable(String, String)

Inicializa una nueva instancia de la clase DataTable utilizando el nombre de tabla y el espacio de nombres especificados.Initializes a new instance of the DataTable class using the specified table name and namespace.

DataTable() DataTable() DataTable()

Inicializa una nueva instancia de la clase DataTable sin argumentos.Initializes a new instance of the DataTable class with no arguments.

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

Ejemplos

En el ejemplo siguiente se crea DataTable un DataColumn nuevo DataRowcon y, y se muestra DataGridView en un control.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

Comentarios

El constructor establece los valores iniciales de todas las propiedades DataTable del objeto.The constructor sets initial values for all properties of the DataTable object. En la tabla siguiente se muestran las propiedades y sus valores predeterminados.The following table shows the properties and their default values. Cuando se crea una DataTable instancia de, las siguientes propiedades de lectura y escritura se establecen en valores iniciales.When an instance of DataTable is created, the following read/write properties are set to initial values.

Propiedad.Property Valor predeterminadoDefault value
CaseSensitiveCaseSensitive Igual que el elemento DataSetprimario, si pertenece a uno.Same as the parent DataSet, if it belongs to one. En caso contrario, es false.Otherwise, false.
DisplayExpressionDisplayExpression Cadena vacía ("")Empty string ("")
Configuración regionalLocale Igual que el CultureInfo objeto DataSet primario (devuelto por la Locale propiedad); si no existe ningún elemento primario, el valor predeterminado es CultureInfoel sistema actual.Same as the parent DataSet object's CultureInfo (returned by the Locale property); if no parent exists, the default is the current system CultureInfo.
MinimumCapacityMinimumCapacity 50 filas.50 rows.

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad.You can change the value for any of these properties through a separate call to the property.

Consulte también:

DataTable(String) DataTable(String) DataTable(String) DataTable(String)

Inicializa una nueva instancia de la clase DataTable con el nombre de tabla especificado.Initializes a new instance of the DataTable class with the specified table name.

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

Nombre que se va a asignar a la tabla.The name to give the table. Si tableName es null o una cadena vacía, se le asigna un nombre predeterminado al agregarlo a DataTableCollection.If tableName is null or an empty string, a default name is given when added to the DataTableCollection.

Ejemplos

En el ejemplo siguiente se DataTable crea un y se muestra DataGridView en un control.The following example creates a DataTable and displays it in a 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:

DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase DataTable con el objeto SerializationInfo y la estructura StreamingContext.Initializes a new instance of the DataTable class with the SerializationInfo and the StreamingContext.

protected:
 DataTable(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
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
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parámetros

info
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

Datos necesarios para serializar o deserializar un objeto.The data needed to serialize or deserialize an object.

context
StreamingContext StreamingContext StreamingContext StreamingContext

Origen y destino de una secuencia de serialización dada.The source and destination of a given serialized stream.

Comentarios

Esta implementación del DataTable constructor es necesaria para ISerializable.This implementation of the DataTable constructor is required for ISerializable.

Consulte también:

DataTable(String, String) DataTable(String, String) DataTable(String, String) DataTable(String, String)

Inicializa una nueva instancia de la clase DataTable utilizando el nombre de tabla y el espacio de nombres especificados.Initializes a new instance of the DataTable class using the specified table name and namespace.

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

Nombre que se va a asignar a la tabla.The name to give the table. Si tableName es null o una cadena vacía, se le asigna un nombre predeterminado al agregarlo a DataTableCollection.If tableName is null or an empty string, a default name is given when added to the DataTableCollection.

tableNamespace
String String String String

Espacio de nombres para la representación XML de los datos almacenados en el objeto DataTable.The namespace for the XML representation of the data stored in the DataTable.

Consulte también:

Se aplica a