Compartilhar via


Como: Adicionar linhas a uma 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.

ObservaçãoObservação

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 uma DataTable

Como: Excluir linhas em uma DataTable.

Como: Confirmar as alterações em um Dataset.

Como: Personalizar a adição de Item com o BindingSource do Windows Forms

Referência

AddingNew

Columns

Conceitos

Adding Data to a DataTable

Outros recursos

Editar dados no seu aplicativo

O Componente BindingSource

Manipulating Data in a DataTable