OleDbCommandBuilder.GetInsertCommand Methode

Definition

Ruft das automatisch generierte OleDbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.Gets the automatically generated OleDbCommand object required to perform insertions at the data source.

Überlädt

GetInsertCommand()

Ruft das automatisch generierte OleDbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.Gets the automatically generated OleDbCommand object required to perform insertions at the data source.

GetInsertCommand(Boolean)

Ruft das automatisch generierte OleDbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.Gets the automatically generated OleDbCommand object required to perform insertions at the data source.

Hinweise

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie den Text des OleDbCommand Objekts zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the OleDbCommand 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 OleDbDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the OleDbDataAdapter.

Nachdem die SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the 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 be still be using information from the previous statement, which might not be correct. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder UpdateCommand oder GetInsertCommandaufruft.The SQL statements are first generated when the application calls either UpdateCommand or GetInsertCommand.

GetInsertCommand()

Ruft das automatisch generierte OleDbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.Gets the automatically generated OleDbCommand object required to perform insertions at the data source.

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();
public System.Data.OleDb.OleDbCommand GetInsertCommand ();
override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand
Public Function GetInsertCommand () As OleDbCommand

Gibt zurück

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

Hinweise

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie den Text des OleDbCommand Objekts zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the OleDbCommand 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 OleDbDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the OleDbDataAdapter.

Nachdem die SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the 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 be still be using information from the previous statement, which might not be correct. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder UpdateCommand oder GetInsertCommandaufruft.The SQL statements are first generated when the application calls either UpdateCommand or GetInsertCommand.

Siehe auch

GetInsertCommand(Boolean)

Ruft das automatisch generierte OleDbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.Gets the automatically generated OleDbCommand object required to perform insertions at the data source.

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.OleDb.OleDbCommand GetInsertCommand (bool useColumnsForParameterNames);
override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

Parameter

useColumnsForParameterNames
Boolean

Generieren Sie bei true Parameternamen, die den Spaltennamen entsprechen, sofern dies möglich ist.If true, generate parameter names matching column names, if it is possible. Bei false werden @p1, @p2 usw. generiert.If false, generate @p1, @p2, and so on.

Gibt zurück

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

Hinweise

Eine Anwendung kann die GetInsertCommand-Methode zu Informationszwecken oder zur Problembehandlung verwenden, da Sie den Text des OleDbCommand Objekts zurückgibt, das ausgeführt werden soll.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the OleDbCommand 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 OleDbDataAdapterfestlegen.For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the OleDbDataAdapter.

Nachdem die SQL-Anweisung erstmalig generiert wurde, muss die Anwendung RefreshSchema explizit aufzurufen, wenn Sie die Anweisung in irgendeiner Weise ändert.After the 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 be still be using information from the previous statement, which might not be correct. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung entweder UpdateCommand oder GetInsertCommandaufruft.The SQL statements are first generated when the application calls either UpdateCommand 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:

Siehe auch

Gilt für: