SqlCommandBuilder.GetInsertCommand Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Balíček:

System.Data.SqlClient v4.8.6

Získá automaticky vygenerovaný SqlCommand objekt, který je nutný k provedení vložení do databáze.

Přetížení

GetInsertCommand()	Získá automaticky vygenerovaný SqlCommand objekt potřebný k provedení vložení do databáze.
GetInsertCommand(Boolean)	Získá automaticky vygenerovaný SqlCommand objekt, který je nutný k provedení vložení do databáze.

Poznámky

Aplikace může použít metodu GetInsertCommand pro informační účely nebo pro účely řešení potíží, protože vrací SqlCommand objekt, který se má spustit.

Můžete také použít GetInsertCommand jako základ upraveného příkazu. Můžete například zavolat GetInsertCommand a upravit CommandTimeout hodnotu a pak ji explicitně nastavit na SqlDataAdapter.

Po prvním vygenerování příkazu Jazyka Transact-SQL musí aplikace explicitně volat RefreshSchema , pokud nějakým způsobem změní příkaz. V opačném GetInsertCommand případě bude stále používat informace z předchozího příkazu, které nemusí být správné. Příkazy Jazyka Transact-SQL se nejprve vygenerují, když aplikace volá buď Update nebo GetInsertCommand.

Další informace najdete v tématu Generování příkazů pomocí CommandBuilders.

GetInsertCommand()

Získá automaticky vygenerovaný SqlCommand objekt potřebný k provedení vložení do databáze.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

Návraty

SqlCommand

Automaticky vygenerovaný SqlCommand objekt potřebný k vložení.

Poznámky

Aplikace může použít metodu GetInsertCommand pro informační účely nebo pro účely řešení potíží, protože vrací SqlCommand objekt, který se má spustit.

Můžete také použít GetInsertCommand jako základ upraveného příkazu. Můžete například zavolat GetInsertCommand a upravit CommandTimeout hodnotu a pak ji explicitně nastavit na SqlDataAdapter.

Po prvním vygenerování příkazu Jazyka Transact-SQL musí aplikace explicitně volat RefreshSchema , pokud nějakým způsobem změní příkaz. V opačném GetInsertCommand případě bude stále používat informace z předchozího příkazu, které nemusí být správné. Příkazy Jazyka Transact-SQL se nejprve vygenerují, když aplikace volá buď Update nebo GetInsertCommand.

Další informace najdete v tématu Generování příkazů pomocí CommandBuilders.

Viz také

• Připojení a načítání dat v ADO.NET
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET

GetInsertCommand(Boolean)

Získá automaticky vygenerovaný SqlCommand objekt, který je nutný k provedení vložení do databáze.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parametry

useColumnsForParameterNames

Boolean

Pokud trueje to možné, vygenerujte názvy parametrů odpovídající názvům sloupců. Pokud false, vygenerujte @p1, @p2atd.

Návraty

SqlCommand

Automaticky vygenerovaný SqlCommand objekt, který je nutný k provedení vložení.

Poznámky

Aplikace může použít metodu GetInsertCommand pro informační účely nebo pro účely řešení potíží, protože vrací SqlCommand objekt, který se má spustit.

Můžete také použít GetInsertCommand jako základ upraveného příkazu. Můžete například zavolat GetInsertCommand a upravit CommandTimeout hodnotu a pak ji explicitně nastavit na SqlDataAdapter.

Po prvním vygenerování příkazu Jazyka Transact-SQL musí aplikace explicitně volat RefreshSchema , pokud nějakým způsobem změní příkaz. V opačném GetInsertCommand případě bude stále používat informace z předchozího příkazu, které nemusí být správné. Příkazy Jazyka Transact-SQL se nejprve vygenerují, když aplikace volá buď Update nebo GetInsertCommand.

Výchozí chování při generování názvů parametrů je použití @p1, @p2atd. pro různé parametry. Předání true parametru useColumnsForParameterNames vám umožní vynutit OleDbCommandBuilder generování parametrů na základě názvů sloupců. To bude úspěšné pouze v případě, že jsou splněny následující podmínky:

• Byla zadána vrácená ParameterNameMaxLength volání metody GetSchema a nalezená v DataSourceInformation kolekci a její délka se rovná nebo větší než vygenerovaný název parametru.

• Vygenerovaný název parametru splňuje kritéria zadaná ve ParameterNamePattern vráceném volání metody GetSchema a nalezen v regulárním výrazu DataSourceInformation kolekce.

• ParameterMarkerFormat Vrácené z volání metody GetSchema a nalezené v kolekci DataSourceInformation je zadán.

Další informace najdete v tématu Generování příkazů pomocí CommandBuilders.

Viz také

• Připojení a načítání dat v ADO.NET
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET