FireDAC.Stan.Option.TFDFetchOptions.Items

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Items: TFDFetchItems read GetItems write SetItems

C++

__property TFDFetchItems Items = {read=GetItems, write=SetItems, stored=IsIS, default=7};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
FireDAC.Stan.Option TFDFetchOptions

Beschreibung

Steuert, welche Art Daten abgerufen werden sollen.

Mit der Eigenschaft Items steuern Sie, welche Typen von Daten und Metadaten abgerufen werden sollen.

Option

Beschreibung

fiBlobs

Wenn angegeben, werden die BLOB-Feldwerte zusammen mit anderen Datensatzfeldern abgerufen. Ansonsten wird das Abrufen verzögert, bis ein BLOB-Wert wirklich gelesen wird.

Hinweis: Durch Ausschließen von fiBlobs aus Items wird die SELECT-Liste einer SQL-Anweisung nicht geändert. Wenn ein DBMS BLOB-Werte per Wert überträgt (z. B. Oracle LONG, MySQL, SQL Server, SQLite), werden die BLOB-Werte in jedem Fall an den Client, nicht an das Netzwerk gesendet. Sie werden allerdings nicht im Datensatzzwischenspeicher des Clients gespeichert. Wenn aber ein DBMS BLOB-Werte per Referenz überträgt (z. B Oracle CLOB/BLOB, InterBase, Firebird), dann werden die BLOB-Werte weder gesendet noch gespeichert.

fiDetails

Wenn angegeben, dann werden die verschachtelten Cursor-Felder zusammen mit anderen Datensatzfeldern abgerufen. Ansonsten wird das Abrufen so lange verschoben, bis der Wert eines verschachtelten Cursors wirklich gelesen wird.

fiMeta

Wenn angegeben, dann werden die Metadaten der Anweisung abgerufen. Ansonsten muss der Programmierer Metadaten bereitstellen. Die Art der Metadaten und der Zeitpunkt, zu dem sie abgerufen werden, hängen von der Art der Anweisung ab:

  • TFDCustomStoredProc, CommandKind = ckStoredProc usw. Die Metadaten sind die Beschreibung der Parameter der gespeicherten Prozedur. Sie werden beim Aufruf von Prepare abgerufen. Wenn fiMeta nicht in Items enthalten ist, dann muss der Programmierer die Params-Kollektion ausfüllen.
  • TFDCustomQuery, CommandKind = ckSelect usw. Die Metadaten sind die Menge der Basistabellenspalten, die den Primärschlüssel der Tabelle bilden. Sie werden zum automatischen Erzeugen der SQL-Aktualisierungsanweisungen verwendet. Die Metadaten werden bei den "Open"/"Define"-Aufrufen abgerufen. Wenn fiMeta nicht in Items enthalten ist, dann muss der Programmierer eine der folgenden Aktionen ausführen, um die Primärschlüsselfelder anzugeben:
  • pfInKey in ProviderFlags für Primärschlüsselfelder einbeziehen.
  • KeyFields auf die Liste der durch Komma getrennten Primärschlüsselfeldnamen setzen.
  • coInKey in TFDDatSColumn.Options für Primärschlüsselfelder einbeziehen.

Der Vorgabewert ist [fiBlobs, fiDetails, fiMeta]. Das bedeutet, dass alle Daten und Metadaten im geeigneten Moment automatisch abgerufen werden.

Siehe auch