Compartir a través de

Creación de una tabla de datos

Un DataTable, que representa una tabla de datos relacionales en memoria, puede ser creado y utilizado de forma independiente, o puede ser utilizado por otros objetos de .NET Framework, normalmente como miembro de un DataSet.

Puede crear un objeto DataTable mediante el constructor DataTable adecuado. Puede agregarlo a DataSet mediante el método Add para agregarlo a la colección Tables del objeto DataSet.

También puede crear objetos DataTable dentro de un dataSet mediante los métodos Fill o FillSchema del objeto DataAdapter, o desde un esquema XML predefinido o inferido mediante los métodos ReadXml, ReadXmlSchema o InferXmlSchema del DataSet. Tenga en cuenta que después de agregar una 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.

Cuando se crea por primera vez una DataTable, no tiene un esquema (es decir, una estructura). Para definir el esquema de la tabla, debe crear y agregar DataColumn objetos a la colección Columns de la tabla. También puede definir una columna de clave principal para la tabla y crear y agregar objetos Constraint a la colección Constraints de la tabla. Después de definir el esquema de una tabla DataTable, puede agregar filas de datos a la tabla agregando objetos DataRow a la colección Rows de la tabla.

No es necesario proporcionar un valor para la TableName propiedad al crear una DataTable; puede especificar la propiedad en otro momento o dejarla vacía. Sin embargo, al agregar una tabla sin un valor TableName a un Conjunto de datos, a la tabla se le asignará un nombre predeterminado incremental de la tablaN, empezando por "Table" para Table0.

Nota:

Se recomienda evitar la convención de nomenclatura "TableN" al proporcionar un valor TableName , ya que el nombre que proporcione puede entrar en conflicto con un nombre de tabla predeterminado existente en dataSet. Si el nombre proporcionado ya existe, se produce una excepción.

En el ejemplo siguiente se crea una instancia de un objeto DataTable y se le asigna el nombre "Customers".

Dim workTable as DataTable = New DataTable("Customers")  

DataTable workTable = new DataTable("Customers");

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

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  

DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");

Consulte también