FireDAC.Comp.Client.TFDUpdateSQL.Apply
Delphi
procedure Apply(ARequest: TFDUpdateRequest; var AAction: TFDErrorAction; AOptions: TFDUpdateRowOptions); override;
C++
virtual void __fastcall Apply(Firedac::Stan::Option::TFDUpdateRequest ARequest, Firedac::Stan::Intf::TFDErrorAction &AAction, Firedac::Stan::Option::TFDUpdateRowOptions AOptions);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDUpdateSQL |
Beschreibung
Übernimmt eine Anforderung zur Aktualisierung des aktuellen Datensatzes in DataSet in die DB an.
Rufen Sie Apply auf, um die Änderungen des aktuellen DataSet-Datensatzes in die Datenbank zu übernehmen.
Die Standardimplementierung für TFDUpdateSQL setzt die Parameter für eine SQL-Anweisung und führt sie zum Aktualisieren des Datensatzes aus. ARequest gibt den Aktualisierungstyp an und legt für TFDUpdateSQL fest, welche SQL-Anweisung ausgeführt werden soll. Wenn die entsprechende SQL-Anweisung nicht festgelegt ist, dann generiert FireDAC eine Standardanweisung (wie wenn TFDAdaptedDataSet.UpdateObject nicht festgelegt ist).
Apply ist primär für das manuelle Ausführen von Aktualisierungsanweisungen in einer Ereignisbehandlungsroutine für OnUpdateRecord vorgesehen. Die Argumentwerte ARequest, AAction und AOptions der Ereignisbehandlungsroutine müssen den entsprechenden Argumenten der Methode Apply zugewiesen werden.
ARequest kann einen der folgenden Werte annehmen:
|
Wert |
Bedeutung |
TFDUpdateSQL SQL-Eigenschaft |
|---|---|---|
|
|
Fügt einen Datensatz in die Datenbank ein. |
InsertSQL |
|
|
Aktualisiert einen Datensatz in der Datenbank. |
ModifySQL |
|
|
Löscht einen Datensatz aus der Datenbank. |
DeleteSQL |
|
|
Sperrt einen Datensatz in der Datenbank. |
LockSQL |
|
|
Gibt eine Datensatzsperre in der Datenbank frei. |
UnlockSQL |
|
|
Ruft einen Datensatz aus der Datenbank erneut ab. |
FetchRowSQL |
|
|
Aktualisiert die Oracle BLOB/CLOB-Werte in der Datenbank. |
- |
|
|
Ruft die Werte der Generatoren ab, die in den Datensatz einbezogen werden sollen. |
- |
AAction gibt den Ausführungsstatus der Methode Apply zurück, indem angegeben wird, welche Aktion der aufrufende Code durchführen soll. Normalerweise wird dieser Status vom FireDAC-Code verwendet. Wenn die Methode Apply aus der Ereignisbehandlungsroutine für OnUpdateRecord aufgerufen wird, dann weisen Sie das AAction-Argument der Ereignisbehandlungsroutine dem AAction-Argument der Methode Apply zu. Verwenden Sie andernfalls eaDefault als Anfangswert.
AOptions legt zusätzliche Optionen fest. Wenn die Methode Apply aus der Ereignisbehandlungsroutine für OnUpdateRecord aufgerufen wird, dann weisen Sie dem AOptions-Argument der Methode Apply den AOptions-Argument der Ereignisbehandlungsroutine zu. Verwenden Sie andernfalls [] als Wert.