Como adicionar linhas a um DataTable

Para adicionar novos registros em um DataSet, uma nova linha de dados deve ser criada e adicionada à coleção DataRow (Rows) de um DataTable no DataSet. Os procedimentos a seguir mostram como criar uma nova linha e inseri-la em um DataTable. Exemplos são fornecidos para datasets tipados e não tipados.

Dica

Aplicativos que usam controles vinculados a dados normalmente obtém a capacidade de adicionar novos registros através do botão " Adicionar Novo " em um Controle BindingNavigator.

Inserir um novo registro em um dataset tipado

Para esse exemplo, pressupõe-se que um DataSet tem um Customers DataTable e tem duas colunas chamadas CustomerID e CompanyName. DataSets tipados expõem os nomes de coluna como propriedades do objeto tipado DataRow; nesse caso a CustomersRow.

Para adicionar um novo registro em um dataset tipado

• Declare uma nova instância para o dataset tipado. No exemplo a seguir, você declara uma nova instância da classe CustomersRow, atribui a ela uma nova linha, preenche as colunas com dados, e adiciona a nova linha à coleção Rows da tabela Customers:

  Dim newCustomersRow As NorthwindDataSet.CustomersRow
  newCustomersRow = NorthwindDataSet1.Customers.NewCustomersRow()
  
  newCustomersRow.CustomerID = "ALFKI"
  newCustomersRow.CompanyName = "Alfreds Futterkiste"
  
  NorthwindDataSet1.Customers.Rows.Add(newCustomersRow)
  

  NorthwindDataSet.CustomersRow newCustomersRow = 
      northwindDataSet1.Customers.NewCustomersRow();
  
  newCustomersRow.CustomerID = "ALFKI";
  newCustomersRow.CompanyName = "Alfreds Futterkiste";
  
  northwindDataSet1.Customers.Rows.Add(newCustomersRow);
  

Insere um novo registro em um dataset não tipado

Para esse exemplo, presume-se que o dataset não tipado tem um Customers DataTable que tem duas colunas chamadas CustomerID e CompanyName. Datasets não tipados necessitam conhecer os nomes de coluna ou índices quando codificados. Este exemplo usa nomes de coluna.

Para adicionar um registro em um dataset não tipado

• Chame o método NewRow de um DataTable para criar uma nova linha vazia. Essa nova linha herda sua estrutura de coluna da DataColumnCollection da tabela de dados. O código a seguir cria uma nova linha, a preenche com dados e a adiciona à coleção da tabela Rows.

  Dim newCustomersRow As DataRow = DataSet1.Tables("Customers").NewRow()
  
  newCustomersRow("CustomerID") = "ALFKI"
  newCustomersRow("CompanyName") = "Alfreds Futterkiste"
  
  DataSet1.Tables("Customers").Rows.Add(newCustomersRow)
  

  DataRow newCustomersRow = dataSet1.Tables["Customers"].NewRow();
  
  newCustomersRow["CustomerID"] = "ALFKI";
  newCustomersRow["CompanyName"] = "Alfreds Futterkiste";
  
  dataSet1.Tables["Customers"].Rows.Add(newCustomersRow);
  

Consulte também

Tarefas

Como editar linhas em um DataTable

Como excluir linhas em um DataTable

Como confirmar alterações em um conjunto de dados

Como personalizar a adição de item com o BindingSource dos Windows Forms

Referência

AddingNew

Columns

Conceitos

Editando dados no aplicativo

Adicionando dados a um DataTable

Outros recursos

Componente BindingSource

Manipulando dados em uma DataTable