Freigeben über


SqlCommandBuilder.GetInsertCommand Methode

Definition

Ü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.SqlCommand
override this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

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.

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.SqlCommand
override this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parameter

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:

Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.

Gilt für: