Compartilhar via

Criando uma DataTable

Um DataTable, que representa uma tabela de dados relacionais na memória, pode ser criado e usado de forma independente ou pode ser usado por outros objetos do .NET Framework, mais comumente como membro de um DataSet.

Você pode criar um objeto DataTable usando o construtor DataTable apropriado. 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 os métodos ReadXml, ReadXmlSchema ou InferXmlSchema do DataSet. Observe que depois de adicionar um DataTable como membro da coleção Tables de um DataSet, você não poderá adicioná-lo à coleção de tabelas de qualquer outro DataSet.

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

Você não é obrigado a fornecer um valor para a TableName propriedade 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á um nome padrão incremental da TabelaN, começando com "Table" para Table0.

Observação

Recomendamos que você evite a convenção de nomenclatura "TabelaN" 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, uma exceção será gerada.

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

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");

Consulte também