FireDAC.Comp.Client.TFDCustomCommand.Define

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

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 ATablenil 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;

Siehe auch