SqlCommandBuilder.GetInsertCommand Methode

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Ruft das automatisch generierte SqlCommand Objekt ab, das zum Ausführen von Einfügungen in die Datenbank erforderlich ist.

Überlädt

Name	Beschreibung
GetInsertCommand()	Ruft das automatisch generierte SqlCommand Objekt ab, das zum Ausführen von Einfügungen in die Datenbank erforderlich ist.
GetInsertCommand(Boolean)	Ruft das automatisch generierte SqlCommand Objekt ab, das zum Ausführen von Einfügungen in die Datenbank erforderlich ist.

Hinweise

Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da sie das SqlCommand auszuführende Objekt zurückgibt.

Sie können auch als Grundlage für einen geänderten Befehl verwenden GetInsertCommand . Sie können z. B. den Wert aufrufen GetInsertCommand und ändern und diese dann explizit für das Festlegen festlegenSqlDataAdapter.CommandTimeout

Nachdem die Transact-SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit RefreshSchema aufrufen, wenn sie die Anweisung auf irgendeine Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht korrekt ist. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommand aufruft.

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

GetInsertCommand()

Ruft das automatisch generierte SqlCommand Objekt ab, das zum Ausführen von Einfügungen in die 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 automatisch generierte SqlCommand Objekt, das zum Ausführen von Einfügungen erforderlich ist.

Hinweise

Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da sie das SqlCommand auszuführende Objekt zurückgibt.

Sie können auch als Grundlage für einen geänderten Befehl verwenden GetInsertCommand . Sie können z. B. den Wert aufrufen GetInsertCommand und ändern und diese dann explizit für das Festlegen festlegenSqlDataAdapter.CommandTimeout

Nachdem die Transact-SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit RefreshSchema aufrufen, wenn sie die Anweisung auf irgendeine Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht korrekt ist. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommand aufruft.

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 zum Ausführen von Einfügungen in die 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

Falls truemöglich, generieren Sie Parameternamen, die Spaltennamen entsprechen. Wenn false, generieren @p1, @p2usw.

Gibt zurück

SqlCommand

Das automatisch generierte SqlCommand Objekt, das zum Ausführen von Einfügungen erforderlich ist.

Hinweise

Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da sie das SqlCommand auszuführende Objekt zurückgibt.

Sie können auch als Grundlage für einen geänderten Befehl verwenden GetInsertCommand . Sie können z. B. den Wert aufrufen GetInsertCommand und ändern und diese dann explizit für das Festlegen festlegenSqlDataAdapter.CommandTimeout

Nachdem die Transact-SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit RefreshSchema aufrufen, wenn sie die Anweisung auf irgendeine Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht korrekt ist. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommand aufruft.

Das Standardverhalten beim Generieren von Parameternamen besteht darin, für die verschiedenen Parameter zu verwenden@p1@p2, usw. Durch Übergeben true für den useColumnsForParameterNames Parameter können Sie erzwingen OleDbCommandBuilder , dass die Parameter stattdessen 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 Wert wurde angegeben, und die Länge ist gleich oder größer als der generierte Parametername.

• Der generierte Parametername erfüllt die kriterien, die ParameterNamePattern im zurückgegebenen GetSchema-Methodenaufruf angegeben und im regulären Ausdruck der DataSourceInformation Auflistung gefunden werden.

• Es wird ein ParameterMarkerFormat vom GetSchema-Methodenaufruf zurückgegeben und in der DataSourceInformation Auflistung gefunden.

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