SqlCommandBuilder.GetInsertCommand Methode

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.

Ü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.

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.

GetInsertCommand()

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.

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

Gibt zurück

SqlCommand

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.

Weitere Informationen

• Verbinden und Abrufen von Daten in ADO.NET
• Verwenden des .NET Framework-Datenanbieters für SQL Server
• Übersicht über ADO.NET

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:
 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

Parameter

useColumnsForParameterNames

Boolean

Generiert beim Wert true Parameternamen, die den Spaltennamen entsprechen (falls möglich). Wenn false, @p1, @p2 usw. generieren.

Gibt zurück

SqlCommand

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.

Weitere Informationen

• Verbinden und Abrufen von Daten in ADO.NET
• Verwenden des .NET Framework-Datenanbieters für SQL Server
• Übersicht über ADO.NET