FireDAC.Stan.Option.TFDFetchOptions.Items

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi 

property Items: TFDFetchItems read GetItems write SetItems

C++ 

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

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
 FireDAC.Stan.Option TFDFetchOptions

Description

Contrôle le type de données à extraire.

Utilisez la propriété Items pour contrôler les types de données et de métadonnées à extraire.

Option

Description

fiBlobs

Lorsque cette option est incluse, les valeurs des champs BLOB sont extraites en même temps que les autres champs d'enregistrements. Sinon, l'extraction est différée jusqu'à ce que la valeur du champ BLOB soit réellement lue.

Remarque : Le fait d'exclure fiBlobs de Items ne modifie pas la liste SELECT d'une commande SQL. Si un SGBD transfère les valeurs des champs BLOB par valeur (par ex., champs LONG Oracle, MySQL, SQL Server, SQLite), ces valeurs BLOB sont fournies au client, et non pas au réseau. Mais elles ne sont pas stockées dans le cache des enregistrements du client. Par contre, si un SGBD transfère les valeurs des champs BLOB par référence (par exemple, champs CLOB / BLOB Oracle, InterBase, Firebird), ces valeurs ne sont ni fournies, ni stockées.

fiDetails

Lorsque cette option est incluse, les champs du curseur imbriqué sont extraits en même temps que les autres champs d'enregistrements. Sinon, l'extraction est différée jusqu'à ce que la valeur du curseur imbriqué soit réellement lue.

fiMeta

Lorsqu'elle est incluse, les métadonnées de la commande sont extraites. Sinon, le programmeur doit fournir lui-même des métadonnées. Le type de métadonnées et le moment auquel elles sont extraites dépendent du type de commande :

  • TFDCustomStoredProc, CommandKind=ckStoredProc, etc. Les métadonnées sont la description des paramètres de la procédure stockée. Elles sont extraites lors de l'appel à Prepare. Si fiMeta ne se trouve pas dans Items, le programmeur doit renseigner lui-même la collection Params.
  • TFDCustomQuery, CommandKind=ckSelect, etc. Les métadonnées sont l'ensemble de colonnes de la table de base, formant la clé primaire de la table. Elles sont utilisées pour gérer automatiquement la mise à jour des commandes SQL. Les métadonnées sont extraites lors des appels à Open / Define. Si fiMeta ne se trouve pas dans Items, le programmeur doit effectuer l'une des opérations suivantes pour spécifier les champs de clé primaire :
  • Inclure pfInKey dans ProviderFlags pour les champs de clé primaire.
  • Définir KeyFields sur la liste de noms de champs de clé primaire séparés par deux points.
  • Inclure coInKey dans TFDDatSColumn.Options pour les colonnes de clé primaire.

La valeur par défaut est [fiBlobs, fiDetails, fiMeta], ce qui signifie que toutes les données et les métadonnées sont extraites automatiquement aux moments adéquats.

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/Libraries/Athens/f/index.php?title=FireDAC.Stan.Option.TFDFetchOptions.Items&oldid=548579 »