SqlCommandBuilder.GetInsertCommand Method

Definition

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated SqlCommand object that is required to perform insertions on the database.

Overloads

GetInsertCommand()

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated SqlCommand object required to perform insertions on the database.

GetInsertCommand(Boolean)

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated SqlCommand object that is required to perform insertions on the database.

Remarks

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie das SqlCommand Objekt zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the SqlCommand object to be executed.

Sie können GetInsertCommand auch als Grundlage für einen geänderten Befehl verwenden.You can also use GetInsertCommand as the basis of a modified command. Beispielsweise können Sie GetInsertCommand aufzurufen und den CommandTimeout Wert ändern und diesen dann explizit für die SqlDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the SqlDataAdapter.

Nachdem die Transact-SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the Transact-SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. Andernfalls werden die GetInsertCommand weiterhin Informationen aus der vorherigen Anweisung verwenden, die möglicherweise nicht korrekt sind.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommandaufruft.The Transact-SQL statements are first generated when the application calls either Update or GetInsertCommand.

Weitere Informationen finden Sie unter Erstellen von Befehlen mit CommandBuilder.For more information, see Generating Commands with CommandBuilders.

GetInsertCommand()

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated SqlCommand object required to perform insertions on the database.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public System.Data.SqlClient.SqlCommand GetInsertCommand ();
override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

Returns

SqlCommand

Das für Einfügevorgänge erforderliche, automatisch generierte SqlCommand-Objekt.The automatically generated SqlCommand object required to perform insertions.

Remarks

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie das SqlCommand Objekt zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the SqlCommand object to be executed.

Sie können GetInsertCommand auch als Grundlage für einen geänderten Befehl verwenden.You can also use GetInsertCommand as the basis of a modified command. Beispielsweise können Sie GetInsertCommand aufzurufen und den CommandTimeout Wert ändern und diesen dann explizit für die SqlDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the SqlDataAdapter.

Nachdem die Transact-SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the Transact-SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. Andernfalls werden die GetInsertCommand weiterhin Informationen aus der vorherigen Anweisung verwenden, die möglicherweise nicht korrekt sind.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommandaufruft.The Transact-SQL statements are first generated when the application calls either Update or GetInsertCommand.

Weitere Informationen finden Sie unter Erstellen von Befehlen mit CommandBuilder.For more information, see Generating Commands with CommandBuilders.

See also

GetInsertCommand(Boolean)

Ruft das automatisch generierte SqlCommand-Objekt ab, das für das Ausführen von Einfügevorgängen in der Datenbank erforderlich ist.Gets the automatically generated SqlCommand object that is required to perform insertions on the database.

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

Parameters

useColumnsForParameterNames
Boolean

Generiert beim Wert true Parameternamen, die den Spaltennamen entsprechen (falls möglich).If true, generate parameter names matching column names if possible. Bei false werden @p1, @p2 usw. generiert.If false, generate @p1, @p2, and so on.

Returns

SqlCommand

Das für Einfügevorgänge erforderliche, automatisch generierte SqlCommand-Objekt.The automatically generated SqlCommand object that is required to perform insertions.

Remarks

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie das SqlCommand Objekt zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the SqlCommand object to be executed.

Sie können GetInsertCommand auch als Grundlage für einen geänderten Befehl verwenden.You can also use GetInsertCommand as the basis of a modified command. Beispielsweise können Sie GetInsertCommand aufzurufen und den CommandTimeout Wert ändern und diesen dann explizit für die SqlDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the SqlDataAdapter.

Nachdem die Transact-SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the Transact-SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. Andernfalls werden die GetInsertCommand weiterhin Informationen aus der vorherigen Anweisung verwenden, die möglicherweise nicht korrekt sind.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Die Transact-SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder Update oder GetInsertCommandaufruft.The Transact-SQL statements are first generated when the application calls either Update or GetInsertCommand.

Das Standardverhalten bei der Erstellung von Parameternamen ist die Verwendung von @p1, @p2usw. für die verschiedenen Parameter.The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. Wenn Sie true für den useColumnsForParameterNames-Parameter übergeben, können Sie erzwingen, dass die OleDbCommandBuilder Parameter auf der Grundlage der Spaltennamen generieren.Passing true for the useColumnsForParameterNames parameter lets you force the OleDbCommandBuilder to generate parameters based on the column names instead. Dies ist nur erfolgreich, wenn die folgenden Bedingungen erfüllt sind:This succeeds only if the following conditions are met:

Weitere Informationen finden Sie unter Erstellen von Befehlen mit CommandBuilder.For more information, see Generating Commands with CommandBuilders.

See also

Applies to