SqlCommandBuilder.GetInsertCommand Metoda

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

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

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

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

Public Function GetInsertCommand () As SqlCommand

Návraty

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

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

Návraty

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