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 DataSetarquivo .

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 dentro de 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 pode adicioná-lo à coleção de tabelas de qualquer outro DataSet.

Quando você cria uma DataTable pela primeira vez, ela 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 para um DataTable, você pode 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 quando cria uma DataTable, você pode especificar a propriedade em outro momento ou pode deixá-la vazia. No entanto, quando você adiciona uma tabela sem um valor TableName a um DataSet, a tabela receberá um nome padrão incremental de TabelaN, começando com "Table" para Table0.

Nota

Recomendamos que você evite a convenção de nomenclatura "TabelaN" ao fornecer um valor TableName , porque 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á lançada.

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

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

O exemplo a seguir cria uma instância de um DataTable adicionando-o à 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