SqlCommandBuilder.GetInsertCommand 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
| GetInsertCommand() |
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist. |
| GetInsertCommand(Boolean) |
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist. |
GetInsertCommand()
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();member this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetInsertCommand () As SqlCommandGibt zurück
Das für Einfügevorgänge erforderliche, automatisch generierte SqlCommand-Objekt.
Hinweise
Eine Anwendung kann die GetInsertCommand -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 GetInsertCommand . Beispielsweise können Sie den CommandTimeout Wert aufrufen GetInsertCommand 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. GetInsertCommand 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 GetInsertCommandaufruft.
Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.
Gilt für:
GetInsertCommand(Boolean)
Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);member this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetInsertCommand (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 Einfügevorgänge erforderliche, automatisch generierte SqlCommand-Objekt.
Hinweise
Eine Anwendung kann die GetInsertCommand -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 GetInsertCommand . Beispielsweise können Sie den CommandTimeout Wert aufrufen GetInsertCommand 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. GetInsertCommand 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 GetInsertCommandaufruft.
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.