FireDAC.Comp.Client.TFDCustomUpdateObject.Apply
Delphi
procedure Apply(ARequest: TFDUpdateRequest; var AAction: TFDErrorAction; AOptions: TFDUpdateRowOptions); virtual; abstract;
C++
virtual void __fastcall Apply(Firedac::Stan::Option::TFDUpdateRequest ARequest, Firedac::Stan::Intf::TFDErrorAction &AAction, Firedac::Stan::Option::TFDUpdateRowOptions AOptions) = 0 ;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomUpdateObject |
Beschreibung
Übernimmt die Anforderung zum Aktualisieren des Datensatzes für den aktuellen DataSet-Datensatz in die Datenbank.
Mit Apply übernehmen Sie Änderungen des aktuellen DataSet-Datensatzes in die Datenbank.
Die Standardimplementierung (TFDUpdateSQL) setzt Parameter für eine SQL-Anweisung und führt sie zum Aktualisieren eines Datensatzes aus. ARequest gibt die Aktualisierungsart an, mit TFDUpdateSQL wird z. B. festgelegt, welche SQL-Anweisung ausgeführt werden soll. Wenn keine passende SQL-Anweisung angegeben ist, dann generiert FireDAC eine Standardanweisung, genau wie wenn TFDAdaptedDataSet.UpdateObject nicht angegeben ist.
Apply ist hauptsächlich für das manuelle Ausführen von Aktualisierungsanweisungen aus einer OnUpdateRecord-Ereignisbehandlungsroutine vorgesehen. Die Argumentwerte von ARequest, AAction und AOptions müssen den entsprechenden Werten der Methode Apply zugewiesen werden. Für ARequest ist einer der folgenden Werte möglich:
|
Wert |
Bedeutung |
TFDUpdateSQL-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 die Datensatzsperre in der Datenbank frei. |
UnlockSQL |
|
|
Ruft einen Datensatz aus der Datenbank ab. |
FetchRowSQL |
|
|
Aktualisiert Oracle BLOB/CLOB-Werte in der Datenbank. |
- |
|
|
Ruft Generatorwerte ab, die in den Datensatz übernommen werden sollen. |
- |
AAction gibt den Ausführungsstatus der Methode Applyzurück, indem angegeben wird, welche Aktion der aufrufende Code ausführen soll. Normalerweise wird dieser Status vom FireDAC-Code verwendet. Wenn die Methode Apply aus der Ereignisbehandlungsroutine OnUpdateRecord aufgerufen wird, weisen Sie das Argument AAction der Ereignisbehandlungsroutine dem Argument AAction der Methode Apply zu. Verwenden Sie andernfalls eaDefault als Anfangswert.
AOptions legt zusätzliche Optionen fest. Wenn die Methode Apply aus der Ereignisbehandlungsroutine OnUpdateRecord aufgerufen wird, weisen Sie das Argument AOptions der Ereignisbehandlungsroutine dem Argument AOptions der Methode Apply zu. Verwenden Sie andernfalls [] als Wert.
Siehe auch
- Überschreiben von Eintragsaktualisierungen
- FireDAC.Comp.Client.TFDUpdateSQL
- FireDAC.Comp.Client.TFDAdaptedDataSet.UpdateObject
Beispiele
- FireDAC TFDQuery OnUpdateRecord (Beispiel)