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

Pode criar um DataTable objeto usando o construtor apropriado DataTable . Pode adicioná-lo ao DataSet usando o método Add para o adicionar na coleção Tables do objeto DataSet.

Também pode criar DataTable objetos dentro de um DataSet usando os métodos Fill ou FillSchema do objeto DataAdapter, ou a partir de um esquema XML predefinido ou inferido usando o ReadXml, o ReadXmlSchema, ou InferXmlSchema métodos do DataSet. Note que, depois de adicionar a DataTable como membro da Tables coleção de um DataSet, 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, deve criar e adicionar DataColumn objetos à Columns coleção da tabela. Também pode definir uma coluna de chave primária para a tabela e criar e adicionar Constraint objetos à Constraints coleção da tabela. Depois de definir o esquema para uma DataTable, pode adicionar linhas de dados à tabela adicionando DataRow objetos à Rows coleção 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 adiciona uma tabela sem valor TableName a um DataSet, a tabela recebe um nome predefinido incremental, TableN, começando com "Table" para Table0.

Observação

Recomendamos que evite a convenção de nomenclatura "TabelaN" ao fornecer um TableName valor, pois o nome que fornece pode entrar em conflito com um nome de tabela padrão existente no DataSet. Se o nome fornecido já existir, uma exceção é gerada.

O exemplo seguinte cria uma instância de um DataTable objeto e atribui-lhe o nome "Clientes."

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

O exemplo seguinte cria uma instância de a DataTable ao adicioná-la à Tables coleção 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");

Ver também