Inserir novos registros em um banco de dados em aplicativos do .NET Framework

Para inserir novos registros em um banco de dados com ADO.NET em um projeto do .NET Framework, a abordagem comum é usar métodos TableAdapter . Os TableAdapters habilitam a comunicação entre o aplicativo e o banco de dados. Eles fornecem diferentes maneiras de inserir novos registros em um banco de dados, dependendo dos requisitos do aplicativo. Você pode usar o TableAdapter.Update método ou um dos métodos TableAdapter DBDirect (especificamente, o TableAdapter.Insert método).

Este artigo descreve como inserir registros em um banco de dados para um aplicativo criado com ADO.NET e o .NET Framework usando o Visual Basic (VB) ou C#. Se a configuração do aplicativo usar o Entity Framework 6, consulte Adicionando uma nova entidade ao contexto ou para o Entity Framework Core, consulte Adicionando dados.

Pré-requisitos

• Para trabalhar com métodos TableAdapter, você precisa ter uma instância disponível. Para obter mais informações, consulte Criar e configurar TableAdapters em aplicativos do .NET Framework.

• Segurança do .NET: você deve ter acesso ao banco de dados ao qual está tentando se conectar e permissão para executar inserções na tabela desejada.

Escolher método de inserção

Há diferentes abordagens para inserir registros em um banco de dados com base no cenário do aplicativo. A tabela a seguir resume as opções:

Inserir novos registros usando TableAdapters

Se o aplicativo usar conjuntos de dados para armazenar dados, você poderá adicionar novos registros ao conjunto de dados desejado DataTable e, em seguida, chamar o TableAdapter.Update método. O TableAdapter.Update método envia alterações no DataTable banco de dados, incluindo registros modificados e excluídos.

Inserir novos registros com o método TableAdapter.Update

O procedimento a seguir demonstra como inserir novos registros em um banco de dados usando o TableAdapter.Update método:

1. Adicione novos registros ao desejado DataTable criando um novo DataRow e adicionando-o à Rows coleção.

2. Depois de adicionar as novas linhas ao DataTablemétodo, chame o TableAdapter.Update método. Você pode controlar a quantidade de dados a serem atualizados passando um dos seguintes valores de parâmetro:

   • Um DataSet inteiro
   • Um DataTable
   • Uma matriz de DataRows
   • Uma única DataRow

   O código a seguir mostra como adicionar um novo registro a um DataTable e, em seguida, chamar o TableAdapter.Update método para salvar a nova linha no banco de dados. Este exemplo usa a Region tabela no banco de dados Northwind.

   • C#
   • VB

   // Create a new row.
   NorthwindDataSet.RegionRow newRegionRow;
   newRegionRow = northwindDataSet.Region.NewRegionRow();
   newRegionRow.RegionID = 5;
   newRegionRow.RegionDescription = "NorthWestern";
   
   // Add the row to the Region table
   this.northwindDataSet.Region.Rows.Add(newRegionRow);
   
   // Save the new row to the database
   this.regionTableAdapter.Update(this.northwindDataSet.Region);
   

Inserir novos registros com o método TableAdapter.Insert

Se o aplicativo usar objetos para armazenar dados, você poderá usar o TableAdapter.Insert método para criar novas linhas diretamente no banco de dados. O Insert método aceita os valores individuais de cada coluna como parâmetros. Quando você chama o método, um novo registro é inserido no banco de dados com os valores de parâmetro passados.

• Chame o método tableAdapter Insert e passe os valores para cada coluna como parâmetros.

O procedimento a seguir demonstra como usar o TableAdapter.Insert método para inserir linhas. Este exemplo insere dados na Region tabela no banco de dados Northwind.

NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Insert(5, "NorthWestern");

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")

Inserir novos registros com objetos de comando

Você pode inserir novos registros diretamente em um banco de dados usando objetos de comando.

• Crie um novo objeto de comando e, em seguida, defina seu Connection, CommandTypee CommandText propriedades.

O procedimento a seguir demonstra como inserir registros em um banco de dados usando o objeto de comando. Este exemplo insere dados na Region tabela no banco de dados Northwind.

System.Data.SqlClient.SqlConnection sqlConnection1 = 
    new System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING");

System.Data.SqlClient.SqlCommand cmd = new System.Data.SqlClient.SqlCommand();
cmd.CommandType = System.Data.CommandType.Text;
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')";
cmd.Connection = sqlConnection1;

sqlConnection1.Open();
cmd.ExecuteNonQuery();
sqlConnection1.Close();

Dim sqlConnection1 As New System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING")

Dim cmd As New System.Data.SqlClient.SqlCommand
cmd.CommandType = System.Data.CommandType.Text
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')"
cmd.Connection = sqlConnection1

sqlConnection1.Open()
cmd.ExecuteNonQuery()
sqlConnection1.Close()

Conteúdo relacionado

• Salvar dados de volta no banco de dados
• Salvar dados com os métodos TableAdapter DBDirect em aplicativos do .NET Framework