SqlCommandBuilder.GetUpdateCommand Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| GetUpdateCommand() |
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist. |
| GetUpdateCommand(Boolean) |
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist. |
GetUpdateCommand()
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand ();member this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand () As SqlCommandGibt zurück
Das für Aktualisierungen erforderliche, automatisch generierte SqlCommand-Objekt.
Hinweise
Eine Anwendung kann die GetUpdateCommand -Methode zu Informations- oder Problembehandlungszwecken verwenden, da sie das SqlCommand auszuführende Objekt zurückgibt.
Sie können auch als Grundlage für einen geänderten Befehl verwenden GetUpdateCommand . Beispielsweise können Sie den CommandTimeout Wert aufrufen GetUpdateCommand und ändern und dann explizit für SqlDataAdapterfestlegen.
Nachdem die Transact-SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit aufrufen RefreshSchema , wenn sie die Anweisung in irgendeiner Weise ändert. GetUpdateCommand Andernfalls werden weiterhin Informationen aus der vorherigen Anweisung verwendet, die möglicherweise nicht korrekt sind. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetUpdateCommandaufruft.
Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.
Gilt für:
GetUpdateCommand(Boolean)
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Aktualisierungen in der Datenbank erforderlich ist.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);member this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommandParameter
- useColumnsForParameterNames
- Boolean
Generiert beim Wert true Parameternamen, die den Spaltennamen entsprechen (falls möglich). Wenn false, @p1, @p2 usw. generieren.
Gibt zurück
Das für Aktualisierungen erforderliche, automatisch generierte SqlCommand-Objekt.
Hinweise
Eine Anwendung kann die GetUpdateCommand -Methode zu Informations- oder Problembehandlungszwecken verwenden, da sie das SqlCommand auszuführende Objekt zurückgibt.
Sie können auch als Grundlage für einen geänderten Befehl verwenden GetUpdateCommand . Beispielsweise können Sie den CommandTimeout Wert aufrufen GetUpdateCommand und ändern und dann explizit für SqlDataAdapterfestlegen.
Nachdem die Transact-SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit aufrufen RefreshSchema , wenn sie die Anweisung in irgendeiner Weise ändert. GetUpdateCommand Andernfalls werden weiterhin Informationen aus der vorherigen Anweisung verwendet, die möglicherweise nicht korrekt sind. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetUpdateCommandaufruft.
Das Standardverhalten beim Generieren von Parameternamen besteht darin, , @p2usw. für die verschiedenen Parameter zu verwenden@p1. Wenn Sie für den useColumnsForParameterNames Parameter übergebentrue, können Sie erzwingen, OleDbCommandBuilder dass stattdessen Parameter basierend auf den Spaltennamen generiert werden. Dies ist nur erfolgreich, wenn die folgenden Bedingungen erfüllt sind:
Der ParameterNameMaxLength vom GetSchema-Methodenaufruf zurückgegebene und in der DataSourceInformation Auflistung gefundene wurde angegeben, und seine Länge ist gleich oder größer als der generierte Parametername.
Der generierte Parametername erfüllt die Kriterien, die ParameterNamePattern im vom Aufruf der GetSchema-Methode zurückgegebenen und im regulären Ausdruck der DataSourceInformation Auflistung angegeben sind.
Eine ParameterMarkerFormat vom Aufruf der GetSchema-Methode zurückgegebene und in der DataSourceInformation Auflistung gefundene wird angegeben.
Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.