Datasnap.Midas.IAppServer.AS_GetRecords

Aller au parent : IAppServer

Delphi

function  AS_GetRecords(const ProviderName: OleStr; Count: Integer; out RecsOut: Integer;
Options: Integer; const CommandText: OleStr;
var Params: OleVariant; var OwnerData: OleVariant): OleVariant; safecall;

C++

virtual HRESULT __safecall AS_GetRecords(const System::Types::OleStr ProviderName, int Count, /* out */ int &RecsOut, int Options, const System::Types::OleStr CommandText, System::OleVariant &Params, System::OleVariant &OwnerData, System::OleVariant &__AS_GetRecords_result) = 0 ;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Datasnap.Midas.pas Datasnap.Midas.hpp	Datasnap.Midas	IAppServer

Description

Renvoie un paquet de données contenant les données spécifiées.

Appelez AS_AS_GetRecords pour obtenir le nombre spécifié d'enregistrements. AS_GetRecords renvoie les enregistrements requis, en commençant par l'enregistrement courant de l'ensemble de données du fournisseur. Si vous travaillez avec un module de données distant sans état, il peut être nécessaire de repositionner le curseur ou de réexécuter une requête ou une procédure stockée dans le gestionnaire d'événement BeforeAS_GetRecords du fournisseur.

ProviderName spécifie le nom du composant fournisseur qui fournit les enregistrements.

Count indique le nombre ou le type d'enregistrements à récupérer. Si Count a la valeur -1, tous les enregistrements sont extraits. Si Count a la valeur 0, seules les métadonnées sont extraites. Si Count est supérieur à 0, Count enregistrements sont récupérés.

RecsOut renvoie le nombre réel d'enregistrements extraits.

Options indique quelles informations doivent être ajoutées au paquet de données en plus des données. Il s'agit d'une combinaison de constantes GetRecordOption. Par exemple, la valeur suivante demande des métadonnées ainsi qu'un paquet de données codé en XML :

MetaDataOption + XMLOption

MetaDataOption || XMLOption

CommandText spécifie une instruction SQL optionnelle qui remplace le SQL d'une requête ou le nom d'une procédure stockée qui remplace la table ou la procédure stockée du fournisseur. Ce paramètre n'est pas pris en compte si la propriété Options ne contient pas poAllowCommandText.

Params est un Variant contenant tous les paramètres qui doivent être transmis à l'ensemble de données du fournisseur avant qu'il exécute pour générer les données demandées. Il renvoie tous les paramètres en sortie. Vous pouvez effectuer une conversion entre le format Variant des paramètres utilisés par cet argument et un objet TParams à l'aide des routines globales PackageParams et UnPackParams.

OwnerData contient des informations personnalisées qui sont fournies par le gestionnaire d'événement BeforeAS_GetRecords d'un ensemble de données client. Ces informations sont transmises au gestionnaire d'événement BeforeAS_GetRecords du fournisseur. OwnerData renvoie les informations fournies par le gestionnaire d'événement AfterAS_GetRecords du fournisseur.

Les enregistrements sont renvoyés sous la forme d'un paquet de données dans un paramètre Variant, GetRecords_result (C++).