Soap.InvokeRegistry.RemTypeRegistry

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function RemTypeRegistry: TRemotableTypeRegistry;

C++

extern DELPHI_PACKAGE TRemotableTypeRegistry* __fastcall RemTypeRegistry(void);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Soap.InvokeRegistry.pas
Soap.InvokeRegistry.hpp
Soap.InvokeRegistry Soap.InvokeRegistry

Description

Donne accès au registre des types distants.

Appelez RemTypeRegistry pour accéder au registre des types distants. Utilisez la méthode RegisterXSClass de l'objet renvoyé pour recenser une classe distante dans une application qui publie ou utilise des services Web. Utilisez sa méthode RegisterXSInfo pour recenser un type distant.

Les classes distantes sont des classes qui peuvent être transmises entre le client d'une application de services Web et le serveur qui implémente le service. Elles peuvent représenter des types non scalaires de paramètres et de valeurs de retour ou des exceptions déclenchées lors d'une tentative d'exécution d'une requête transmise à une application de services Web. Toutes les classes distantes sont compilées avec les informations de type à l'exécution (RTTI) et disposent d'un constructeur virtuel que le registre des classes distantes reconnaît et utilise pour obtenir des instances de classe.

Les types distants comprennent les tableaux dynamiques, les types énumérés et les types booléens, utilisables dans une interface invocable sans recourir à une représentation de classes distantes, mais qui doivent être recensés car leurs valeurs requièrent un marshaling particulier.

L'application client et l'application serveur doivent recenser les classes et les types distants avant de pouvoir les utiliser. Elles doivent les recenser pour utiliser le même espace de nommage. Vous pouvez fournir cet espace de nommage explicitement quand vous recensez la classe ou le type, ou bien utiliser le domaine généré automatiquement. Dans le deuxième cas, la classe doit être définie dans la même unité sur le client et le serveur ; le client et le serveur doivent tous deux avoir la même valeur définie pour la variable globale AppNameSpacePrefix.

Remarque: Le registre des types distants correspond au registre des classes distantes. Vous pouvez utiliser RemTypeRegistry de façon interchangeable avec la fonction RemClassRegistry.

Voir aussi