Vložení nových záznamů do databáze v aplikacích .NET Framework

Při vkládání nových záznamů do databáze s ADO.NET v projektu rozhraní .NET Framework je běžným přístupem použití metod TableAdapter . Objekty TableAdapter umožňují komunikaci mezi vaší aplikací a databází. Poskytují různé způsoby vložení nových záznamů do databáze v závislosti na požadavcích vaší aplikace. Můžete použít metodu TableAdapter.Update nebo jednu z metod TableAdapter DBDirect (konkrétně metodu TableAdapter.Insert ).

Tento článek popisuje, jak vložit záznamy do databáze pro aplikaci sestavenou pomocí ADO.NET a rozhraní .NET Framework pomocí jazyka Visual Basic (VB) nebo C#. Pokud vaše konfigurace aplikace používá Entity Framework 6, přečtěte si téma Přidání nové entity do kontextu nebo Entity Framework Core, viz Přidání dat.

Požadavky

• Pokud chcete pracovat s metodami TableAdapter, musíte mít dostupnou instanci. Další informace naleznete v tématu Vytváření a konfigurace objektů TableAdapter v aplikacích rozhraní .NET Framework.

• Zabezpečení .NET: Musíte mít přístup k databázi, ke které se pokoušíte připojit, a oprávnění k provedení vložení do požadované tabulky.

Volba metody vložení

Existují různé přístupy k vkládání záznamů do databáze na základě scénáře vaší aplikace. Následující tabulka shrnuje možnosti:

Vložení nových záznamů pomocí objektů TableAdapter

Pokud vaše aplikace k ukládání dat používá datové sady, můžete do požadované DataTable datové sady přidat nové záznamy a pak metodu TableAdapter.Update volat. Metoda TableAdapter.Update odešle všechny změny v DataTable databázi, včetně upravených a odstraněných záznamů.

Vložení nových záznamů pomocí metody TableAdapter.Update

Následující postup ukazuje, jak vložit nové záznamy do databáze pomocí TableAdapter.Update metody:

1. Přidejte do požadovaného objektu DataTable nové záznamy tak, že vytvoříte nový DataRow a přidáte ho Rows do kolekce.

2. Po přidání nových řádků do DataTablemetody zavolejte metodu TableAdapter.Update . Množství dat, která se mají aktualizovat, můžete řídit předáním jedné z následujících hodnot parametrů:

   • Celý DataSet
   • Provede DataTable.
   • Pole s DataRow
   • Jedna DataRow

   Následující kód ukazuje, jak přidat nový záznam do DataTable a potom volat metodu TableAdapter.Update pro uložení nového řádku do databáze. Tento příklad používá Region tabulku v databázi 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);
   

Vložení nových záznamů pomocí metody TableAdapter.Insert

Pokud vaše aplikace k ukládání dat používá objekty, můžete pomocí TableAdapter.Insert této metody vytvořit nové řádky přímo v databázi. Metoda Insert přijímá jednotlivé hodnoty pro každý sloupec jako parametry. Při volání metody se do databáze vloží nový záznam s předanými hodnotami parametrů.

• Zavolejte metodu TableAdapter Insert a předejte hodnoty pro každý sloupec jako parametry.

Následující postup ukazuje, jak použít metodu TableAdapter.Insert pro vložení řádků. Tento příklad vloží data do Region tabulky v databázi Northwind.

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

regionTableAdapter.Insert(5, "NorthWestern");

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")

Vložení nových záznamů s objekty příkazů

Nové záznamy můžete do databáze vložit přímo pomocí objektů příkazů.

• Vytvořte nový objekt příkazu a nastavte jeho Connection, CommandTypea CommandText vlastnosti.

Následující postup ukazuje, jak vložit záznamy do databáze pomocí objektu příkazu. Tento příklad vloží data do Region tabulky v databázi 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()

Související obsah

• Ukládání dat zpět do databáze
• Ukládání dat pomocí metod TableAdapter DBDirect v aplikacích rozhraní .NET Framework