DbCommandBuilder.GetInsertCommand Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.
Überlädt
| GetInsertCommand() |
Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist. |
| GetInsertCommand(Boolean) |
Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist, wobei optional Spalten für Parameternamen verwendet werden. |
Hinweise
Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da der Text des DbCommand zu ausführenden Objekts zurückgegeben wird.
Sie können auch als Grundlage eines geänderten Befehls verwenden GetInsertCommand . Sie können z. B. Befehlstext aufrufen GetInsertCommand und ändern, und dann explizit auf den DbDataAdapterBefehl festlegen.
Nachdem die SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit aufrufenRefreshSchema, wenn sie die Anweisung auf beliebige Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht richtig ist. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung aufruft Update oder GetInsertCommand.
Das Standardverhalten, wenn Parameternamen generiert werden, ist die Verwendung @p1, @p2usw. für die verschiedenen Parameter. Wenn die überladene Version dieses GetInsertCommand Verhaltens angegeben werden kann, können Sie dazu führen, dass die DbCommandBuilder Parameter basierend auf den Spaltennamen generiert werden.
GetInsertCommand()
Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist.
public:
System::Data::Common::DbCommand ^ GetInsertCommand();public System.Data.Common.DbCommand GetInsertCommand ();member this.GetInsertCommand : unit -> System.Data.Common.DbCommandPublic Function GetInsertCommand () As DbCommandGibt zurück
Das für Einfügevorgänge erforderliche, automatisch generierte DbCommand-Objekt.
Hinweise
Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da der Text des DbCommand zu ausführenden Objekts zurückgegeben wird.
Sie können auch als Grundlage eines geänderten Befehls verwenden GetInsertCommand . Sie können z. B. den Befehlstext aufrufen GetInsertCommand und ändern, und dann explizit auf den DbDataAdapterBefehl festlegen.
Nachdem die SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit aufrufenRefreshSchema, wenn sie die Anweisung auf beliebige Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht richtig ist. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung aufruft Update oder GetInsertCommand.
Siehe auch
Gilt für:
GetInsertCommand(Boolean)
Ruft das automatisch generierte DbCommand-Objekt ab, das zum Ausführen von Einfügevorgängen in der Datenquelle erforderlich ist, wobei optional Spalten für Parameternamen verwendet werden.
public:
System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);member this.GetInsertCommand : bool -> System.Data.Common.DbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommandParameter
- useColumnsForParameterNames
- Boolean
Generiert bei einem Wert von true Parameternamen, die den Spaltennamen entsprechen (falls möglich). Wenn der Wert false ist, werden @p1, @p2 usw. generiert.
Gibt zurück
Das für Einfügevorgänge erforderliche, automatisch generierte DbCommand-Objekt.
Hinweise
Eine Anwendung kann die GetInsertCommand Methode für Informations- oder Problembehandlungszwecke verwenden, da der Text des DbCommand zu ausführenden Objekts zurückgegeben wird.
Sie können auch als Grundlage eines geänderten Befehls verwenden GetInsertCommand . Sie können z. B. den Befehlstext aufrufen GetInsertCommand und ändern, und dann explizit auf den DbDataAdapterBefehl festlegen.
Nachdem die SQL-Anweisung zuerst generiert wurde, muss die Anwendung explizit aufrufenRefreshSchema, wenn sie die Anweisung auf beliebige Weise ändert. Andernfalls werden die GetInsertCommand Informationen aus der vorherigen Anweisung weiterhin verwendet, was möglicherweise nicht richtig ist. Die SQL-Anweisungen werden zuerst generiert, wenn die Anwendung aufruft Update oder GetInsertCommand.
Das Standardverhalten, wenn Parameternamen generiert werden, ist die Verwendung @p1, @p2usw. für die verschiedenen Parameter. Durch das Übergeben true des useColumnsForParameterNames Parameters können Sie die DbCommandBuilder Parameter basierend auf den Spaltennamen erzwingen. Die Generierung der Parameter basierend auf Spaltennamen erfolgt nur dann, wenn die folgenden Bedingungen erfüllt sind:
Die ParameterNameMaxLength angegebene Länge ist gleich oder größer als der generierte Parametername.
Der generierte Parametername erfüllt die im ParameterNamePattern regulären Ausdruck angegebenen Kriterien.
Eine ParameterMarkerFormat ist angegeben.