SqlCommandBuilder.GetInsertCommand Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

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

Přetížení

Name	Description
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 explicitně ji nastavit na SqlDataAdapter.

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

Další informace naleznete 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 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 explicitně ji nastavit na SqlDataAdapter.

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

Další informace naleznete 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, vygenerovat @p1, @p2a tak dále.

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 explicitně ji nastavit na SqlDataAdapter.

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

Výchozí chování při generování názvů parametrů je použít @p1@p2, a tak dále 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 proběhne úspěšně pouze v případě, že jsou splněny následující podmínky:

• Vrácená ParameterNameMaxLength volání metody GetSchema a nalezená v DataSourceInformation kolekci byla zadána a její délka je rovna 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 nachází se v regulárním výrazu DataSourceInformation kolekce.

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

Další informace naleznete 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