FireDAC.Comp.Client.TFDCustomCommand.Define
Delphi
function Define(ASchema: TFDDatSManager; ATable: TFDDatSTable = nil; AMetaInfoMergeMode: TFDPhysMetaInfoMergeMode = mmReset): TFDDatSTable; overload;
function Define(ATable: TFDDatSTable = nil; AMetaInfoMergeMode: TFDPhysMetaInfoMergeMode = mmReset): TFDDatSTable; overload;
C++
Firedac::Dats::TFDDatSTable* __fastcall Define(Firedac::Dats::TFDDatSManager* ASchema, Firedac::Dats::TFDDatSTable* ATable = (Firedac::Dats::TFDDatSTable*)(0x0), Firedac::Phys::Intf::TFDPhysMetaInfoMergeMode AMetaInfoMergeMode = (Firedac::Phys::Intf::TFDPhysMetaInfoMergeMode)(0x0))/* overload */;
Firedac::Dats::TFDDatSTable* __fastcall Define(Firedac::Dats::TFDDatSTable* ATable = (Firedac::Dats::TFDDatSTable*)(0x0), Firedac::Phys::Intf::TFDPhysMetaInfoMergeMode AMetaInfoMergeMode = (Firedac::Phys::Intf::TFDPhysMetaInfoMergeMode)(0x0))/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomCommand |
Beschreibung
Definiert die Struktur der DatS-Tabelle.
Die Methode Define definiert die Struktur der DatS-Tabelle für den aktuellen Cursor der Anweisung, wenn die Anweisung geöffnet ist, oder für den ersten Cursor, falls sie geschlossen ist.
Die Methode erstellt eine neue DatS-Tabelle, wenn der Wert des Parameters ATable
nil ist.
Wenn es sich bei der SQL-Anweisung um eine SELECT
-Anweisung handelt und fiMeta in FetchOptions.Items enthalten ist, dann fragt Define die Primärschlüsselfelder für die Tabelle in der FROM
-Klausel ab. Schließlich füllt die Methode die Spaltenliste der DatS-Tabelle.
Diese Methode ist überladen:
- Die erste überladene Methode definiert den DatS-Manager für mehrere Ergebnismengen der Anweisung.
- Die zweite überladene Methode definiert die Struktur der DatS-Tabelle für den aktuellen Cursor der Anweisung.
Beispiel
var
oTab: TFDDatSTable;
....
ADCommand1.Prepare('select * from MyTab');
oTab := ADCommand1.Define;
ADCommand1.Open;
ADCommand1.Fetch(oTab);
ADCommand1.Close;
// Some time later, after the structure of DB table MyTab have changed.
// For example, field was removed.
ADCommand1.Prepare('select * from MyTab');
oTab := ADCommand1.Define(oTab, mmOverride);
ADCommand1.Open;
ADCommand1.Fetch(oTab);
ADCommand1.Close;