Liste des tâches d'accès distant de base
.NET Remoting est l'un des différents moyens d'établir une communication entre des domaines d'application utilisant le .NET Framework. Vous devez décider quelles fonctionnalités sont nécessaires à votre application et prendre en compte les ressources dont vous disposez avant de choisir un modèle de développement particulier pour votre application distribuée. Pour plus d'informations, voir Choix des options de communication dans .NET. Les listes de tâches suivantes décrivent les étapes fondamentales nécessaires à la création d'une application .NET Remoting de base.
Tâches hôte
Les étapes suivantes sont nécessaires pour publier tout service pour une utilisation en dehors de votre domaine d'application :
Concevez votre service.
Choisissez un domaine d'application hôte.
Choisissez un modèle d'activation.
Choisissez un canal et un port.
Décidez comment le client obtiendra les métadonnées de votre service.
Implémentez votre domaine d'application hôte. Les hôtes d'accès distant peuvent être des services Windows, des applications consoles, des applications Windows Forms, des processus Internet Information Services (IIS) ou des applications ASP.NET. La configuration requise varie pour chaque type d'application ; il est donc recommandé de lire la documentation expliquant comment créer le type d'application que vous souhaitez utiliser. Pour plus d'informations, voir Applications Windows ou Applications Web ASP.NET dans le .NET Framework. Dans l'hôte, configurez le système d'accès distant pour un mode d'activation et d'autres informations telles que le nom d'application et le point d'entrée de l'application. Si vous voulez configurer le système par programme, vous n'avez pas besoin d'utiliser un fichier de configuration. Si vous utilisez un fichier de configuration, vous devez charger ce fichier dans le système en appelant RemotingConfiguration.Configure.
Dans l'hôte, créez le canal approprié et inscrivez-le avec le système en appelant ChannelServices.RegisterChannel. Si vous utilisez un fichier de configuration, vous devez charger ce fichier dans le système en appelant RemotingConfiguration.Configure.
L'hôte ne peut pas s'exécuter sans la classe publiée, cependant la façon dont vous générez votre environnement hôte avec l'implémentation de votre service dépend de la manière dont vous voulez partager l'interface publique de votre service.
Si vous implémentez un service Web XML (à l'aide de HttpChannel avec la sérialisation SOAP par défaut), votre client peut obtenir les informations de trois façons différentes :
En utilisant l'outil Soapsuds Tool (Soapsuds.exe) pour extraire les informations à partir du point d'entrée.
En téléchargeant un assembly qui contient les métadonnées.
En téléchargeant le code source d'une interface.
Notes
L'utilisation du code source fonctionnera dans deux cas. Lors de l'utilisation de l'activation par serveur, vous pouvez utiliser le code source d'une implémentation, d'une classe abstraite ou d'une interface seulement si vous compilez ce code dans un assembly portant le même nom que l'implémentation réelle sur le serveur. L'identité des types est fondée sur le nom de type et le nom d'assembly. Lors de l'utilisation de l'activation par client, vous devez générer une classe dont l'aspect est identique à l'implémentation serveur réelle. Spécifiquement, la classe cliente doit être dans un assembly du même nom, elle doit posséder la même déclaration de classe et des membres avec la même signature que ceux sur le serveur. L'implémentation de la classe cliente auxiliaire n'a pas d'importance ; si les métadonnées correspondent, le serveur distant sera appelé. Soapsuds.exe génère une classe auxiliaire pour votre client pour vous épargner cette tâche.
Si vous implémentez un autre type de service (à l'aide d'un objet TcpChannel, par exemple), votre client peut obtenir les informations de deux manières :
En téléchargeant un assembly qui contient les métadonnées.
En téléchargeant le code source d'une interface.
Notes
L'utilisation du code source fonctionnera dans deux cas. Lors de l'utilisation de l'activation par serveur, vous pouvez utiliser le code source d'une implémentation, d'une classe abstraite ou d'une interface seulement si vous compilez ce code dans un assembly portant le même nom que l'implémentation réelle sur le serveur, y compris les informations de versioning. L'identité des types est fondée sur les informations de nom de type et de nom d'assembly. Lors de l'utilisation de l'activation par client, vous devez générer une classe dont l'aspect est identique à l'implémentation serveur réelle. Spécifiquement, la classe cliente doit être dans un assembly du même nom, elle doit posséder la même déclaration de classe et des membres avec la même signature que ceux sur le serveur. L'implémentation de la classe cliente auxiliaire n'a pas d'importance ; si les métadonnées correspondent, le serveur distant sera appelé.
Dans l'un ou l'autre cas, la manière dont vous empaquetez votre service dans votre propre application hôte dépendra de la manière dont vous voulez publier les métadonnées nécessaires aux autres pour consommer le service.
Tâches clientes
Les étapes de base suivantes sont nécessaires pour consommer tout service pour une utilisation en dehors de votre domaine d'application :
Concevez votre client.
Choisissez un domaine d'application client.
Déterminez le mode d'activation et soit l'URL d'activation par client, soit l'URL d'objet connu du type distant.
Considérez si vous avez besoin d'inscrire un canal et un port.
Procurez-vous les métadonnées du type distant.
Implémentez votre domaine d'application client. Les hôtes d'accès distant peuvent être des services Windows, des applications consoles, des applications Windows Forms, des processus Internet Information Services (IIS) ou des applications ASP.NET. La configuration requise varie pour chaque type d'application ; il est donc recommandé de lire la documentation expliquant comment créer le type d'application que vous souhaitez utiliser. Pour plus d'informations, voir Applications Windows ou Applications Web ASP.NET dans le .NET Framework.
Configurez le système d'accès distant du client avec le mode d'activation et d'autres informations de type, telles que le nom de l'application et l'URI (Uniform Resource Identifier) d'objet. Si vous voulez configurer le système par programme, vous n'avez pas besoin d'utiliser un fichier de configuration. Si vous utilisez un fichier de configuration, vous devez charger ce fichier dans le système en appelant RemotingConfiguration.Configure.
Créez le canal approprié et inscrivez-le avec le système en appelant ChannelServices.RegisterChannel. Si vous utilisez un fichier de configuration, vous devez charger ce fichier dans le système en appelant RemotingConfiguration.Configure.
Voir aussi
Concepts
Choix des options de communication dans .NET
Autres ressources
Création d'une application .NET Framework Remoting de base
Vue d'ensemble de .NET Framework Remoting
Exemples d'accès distant