Communication avec l'ensemble de données client

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilisation des composants fournisseur - Index


Toute la communication entre un fournisseur et un ensemble de données client ou agent XML s'effectue par le biais d'une interface Datasnap.Midas.IAppServer. Si le fournisseur figure dans la même application que le client, cette interface est implémentée par un objet caché automatiquement généré ou par un composant Datasnap.Win.TConnect.TLocalConnection. Si le fournisseur fait partie d'une application multiniveau, il s'agit de l'interface du module de données distant du serveur d'application ou (dans le cas d'un serveur SOAP) d'une interface générée par le composant connexion.

La plupart des applications n'utilisent pas IAppServer directement, mais l'invoquent par le biais des propriétés et des méthodes de l'ensemble de données client ou de l'agent XML. Toutefois, lorsque cela est nécessaire, vous pouvez appeler directement l'interface IAppServer à l'aide de la propriété AppServer d'un ensemble de données client.

Le tableau suivant présente les méthodes de l'interface IAppServer, ainsi que les méthodes et les événements correspondants du composant fournisseur et de l'ensemble de données client. Ces méthodes IAppServer comprennent un paramètre Provider. Dans les applications multiniveaux, ce paramètre indique le fournisseur sur le serveur d'applications avec lequel l'ensemble de données client communique. La plupart des méthodes comprennent également un paramètre OleVariant appelé OwnerData qui permet à un ensemble de données client et à un fournisseur d'échanger des informations personnalisées. OwnerData n'est pas utilisé par défaut, mais est transmis à tous les gestionnaires d'événement, de sorte que vous pouvez écrire du code qui permet à votre fournisseur de s'adapter aux informations définies par l'application avant et après chaque appel émanant d'un ensemble de données client.

Membres de l'interface AppServer :

IAppServer Composant fournisseur TClientDataSet

AS_ApplyUpdates (méthode)

ApplyUpdates (méthode), BeforeApplyUpdates (événement), AfterApplyUpdates (événement)

ApplyUpdates (méthode), BeforeApplyUpdates (événement), AfterApplyUpdates (événement)

AS_DataRequest (méthode)

DataRequest (méthode), OnDataRequest (événement)

DataRequest (méthode)

AS_Execute (méthode)

Execute (méthode), BeforeExecute (événement), AfterExecute (événement)

Execute (méthode), BeforeExecute (événement), AfterExecute (événement)

AS_GetParams (méthode)

GetParams (méthode), BeforeGetParams (événement), AfterGetParams (événement)

FetchParams (méthode), BeforeGetParams (événement), AfterGetParams (événement)

AS_GetProviderNames (méthode)

Utilisé pour identifier tous les fournisseurs disponibles.

Utilisé pour créer une liste à la conception pour la propriété ProviderName.

AS_GetRecords (méthode)

GetRecords (méthode), BeforeGetRecords (événement), AfterGetRecords (événement)

GetNextPacket (méthode), Data (propriété), BeforeGetRecords (événement), AfterGetRecords (événement)

AS_RowRequest (méthode)

RowRequest (méthode), BeforeRowRequest (événement), AfterRowRequest (événement)

FetchBlobs (méthode), FetchDetails (méthode), RefreshRecord (méthode), BeforeRowRequest (événement), AfterRowRequest (événement)


Voir aussi

Exemples de code