Criando uma DataTable

  • Artigo

Uma DataTable, que representa uma tabela de dados relacionais de memória, pode ser criada e usada independentemente ou pode ser usada por outros objetos do .NET Framework, mais comumente como membro de um DataSet.

Você pode criar um objeto DataTable usando o construtor apropriado de DataTable. Você pode adicioná-lo ao DataSet usando o método Add para adicioná-lo à coleção Tables do objeto DataSet.

Você também pode criar objetos DataTable em um DataSet usando os métodos Fill ou FillSchema do objeto DataAdapter, ou de um esquema XML predefinido ou inferido usando o método ReadXml, ReadXmlSchema, ou InferXmlSchema do DataSet. Observe que, após adicionar uma DataTable como membro da coleção Tables de um DataSet, você não poderá adicioná-la à coleção de tabelas de qualquer outro DataSet.

Quando você criar uma DataTable pela primeira vez, não terá um esquema (ou seja, uma estrutura). Para definir o esquema da tabela, crie e adicione objetos DataColumn à coleção Columns da tabela. Você também pode definir uma coluna de chave primária para a tabela, e criar objetos Constraint e adicioná-los à coleção Constraints da tabela. Depois que você tiver definido o esquema para DataTable, poderá adicionar linhas de dados à tabela adicionando objetos DataRow à coleção Rows da tabela.

Você não precisa fornecer um valor para a propriedade TableName ao criar uma DataTable; você pode especificar a propriedade em outro momento ou deixá-la vazia. No entanto, quando você adicionar uma tabela sem um valor TableName a um DataSet, a tabela receberá dado um nome padrão incremental TableN, começando com "Table" para Table0.

Observação

É recomendável evitar a convenção de nomenclatura "TableN" ao fornecer um valor TableName, pois o nome fornecido pode entrar em conflito com um nome de tabela padrão existente no DataSet. Se o nome fornecido já existir, será gerada uma exceção.

O exemplo a seguir cria uma instância de um objeto DataTable e atribui a ela o nome "Customers".

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

DataTable workTable = new DataTable("Customers");

O exemplo a seguir cria uma instância de uma DataTable adicionando-a à coleção Tables de um 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");

Confira também