SqlCommandBuilder.GetUpdateCommand Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Přetížení

GetUpdateCommand()	Získá automaticky generovaný SqlCommand objekt potřebný k provedení aktualizací v databázi.
GetUpdateCommand(Boolean)	Získá automaticky generovaný SqlCommand objekt potřebný k provedení aktualizací v databázi.

GetUpdateCommand()

Získá automaticky generovaný SqlCommand objekt potřebný k provedení aktualizací v databázi.

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand ();

override this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand () As SqlCommand

Návraty

SqlCommand

Automaticky vygenerovaný SqlCommand objekt, který je nutný k provedení aktualizací.

Poznámky

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

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

Po prvním vygenerování příkazu Transact-SQL musí aplikace explicitně volat RefreshSchema , pokud nějakým způsobem změní příkaz. V opačném GetUpdateCommand případě bude stále používat informace z předchozího příkazu, což nemusí být správné. Příkazy jazyka Transact-SQL jsou nejprve generovány při volání UpdateGetUpdateCommandnebo aplikace .

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

GetUpdateCommand(Boolean)

Získá automaticky generovaný SqlCommand objekt potřebný k provedení aktualizací v databázi.

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parametry

useColumnsForParameterNames

Boolean

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

Návraty

SqlCommand

Automaticky vygenerovaný objekt vyžadovaný SqlCommand k provedení aktualizací.

Poznámky

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

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

Po prvním vygenerování příkazu Transact-SQL musí aplikace explicitně volat RefreshSchema , pokud nějakým způsobem změní příkaz. V opačném GetUpdateCommand případě bude stále používat informace z předchozího příkazu, což nemusí být správné. Příkazy jazyka Transact-SQL jsou nejprve generovány při volání UpdateGetUpdateCommandnebo aplikace .

Výchozím chováním 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 , aby místo toho vygeneroval parametry založené na názvech sloupců. To je úspěšné, pouze pokud jsou splněny následující podmínky:

• Metoda vrácená ParameterNameMaxLengthvoláním GetSchema 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á v ParameterNamePattern vráceném voláním metody GetSchema a nalezen v regulárním výrazu DataSourceInformation kolekce.

• Je ParameterMarkerFormat zadána metoda vrácená voláním GetSchema , která se nachází v kolekci DataSourceInformation .

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