Compartir a través de


Crear DataTable

Un objeto DataTable, que representa una tabla de datos relacionales en la memoria, se puede crear y usar de manera independiente o lo pueden usar otros objetos de .NET Framework, normalmente como miembro de un objeto DataSet.

Un objeto DataTable se puede crear con el constructor de objetos DataTable o pasando argumentos de constructor al método Add de la propiedad Tables del DataSet, que es una DataTableCollection.

También se pueden crear objetos DataTable dentro de un DataSet con los métodos Fill o FillSchema del objeto DataAdapter, o desde un esquema XML predefinido o inferido, con los métodos ReadXml, ReadXmlSchema o InferXmlSchema del DataSet. Tenga en cuenta que una vez que se ha agregado DataTable como miembro de la colección Tables de un DataSet, no se puede agregar a la colección de tablas de ningún otro DataSet.

La primera vez que se crea un DataTable, no tiene esquema (estructura). Para definir el esquema de la tabla, es necesario crear objetos DataColumn y agregarlos a la colección Columns de la tabla. También se puede definir una columna de claves principales para la tabla y crear objetos Constraint y agregarlos a la colección Constraints de la tabla. Una vez que se ha definido el esquema de DataTable, se pueden agregar filas de datos a la tabla, agregando objetos DataRow a su colección Rows.

No es necesario proporcionar un valor para la propiedad TableName cuando se crea una DataTable: dicha propiedad se puede especificar en otro momento, o se puede dejar vacía. Sin embargo, cuando se agrega una tabla sin valor TableName a un DataSet, la tabla recibirá un nombre predeterminado incremental con el formato TableN y comenzando con "Table" para Table0.

**Nota   **Se recomienda evitar la convención de nomenclatura "Table" o "TableN" si se proporciona un valor para TableName, ya que el nombre que se proporcione podría entrar en conflicto con un nombre de tabla predeterminado existente en el DataSet. Si el nombre proporcionado ya existe, se iniciará una excepción.

En el ejemplo siguiente se crea una instancia de un objeto DataTable, a la que se asigna el nombre "Customers".

Dim workTable as DataTable = New DataTable("Customers")
[C#]
DataTable workTable = new DataTable("Customers");

En el siguiente ejemplo se crea una instancia de una DataTable agregándola a la colección Tables de un DataSet.

Dim custDS As DataSet = New DataSet
Dim custTable As DataTable = custDS.Tables.Add("CustTable")
[C#]
DataSet custDS = new DataSet();
DataTable custTable = custDS.Tables.Add("CustTable");

Vea también

Crear y utilizar DataTables | Llenar un DataSet desde un DataAdapter | Cargar DataSet desde XML | Cargar la información de esquema de DataSet desde XML | DataTable (Clase) | DataTableCollection (Clase)