DispatchRuntime Classe

Définition

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Héritage

Object

DispatchRuntime

Remarques

Utilisez la classe DispatchRuntime pour modifier le comportement par défaut d'un service ou d'un point de terminaison individuel, ou pour insérer des objets implémentant des modifications personnalisées dans l'un ou les deux processus de service suivants :

1. La transformation de messages entrants dans les objets et la diffusion de ces objets comme appels de méthode sur un objet de service.

2. La transformation d'objets reçu de la réponse à un appel d'opération de service dans des messages sortants.

Dans Windows Communication Foundation (WCF), les répartiteurs de canal et de point de terminaison sont les composants de service chargés d’accepter de nouveaux canaux, de recevoir des messages, de distribuer et d’appeler des méthodes et de traiter les réponses. Chaque point de terminaison exposé par un objet ServiceHost possède un répartiteur de point de terminaison et un répartiteur de canal associé ; en outre, chaque client qui participe à la communication duplex possède également un répartiteur de point de terminaison et un répartiteur de canal pour chaque point de terminaison de rappel.

DispatchRuntime vous permet d'intercepter et d'étendre le canal ou le répartiteur de point de terminaison pour tous les messages à travers un contrat particulier, même lorsqu'un message n'est pas reconnu. Lorsqu'un message arrive et qu'il ne correspond à aucun message déclaré dans le contrat, il est distribué à l'opération retournée par la propriété UnhandledDispatchOperation. Pour intercepter ou étendre à travers tous les messages une opération particulière, consultez la classe DispatchOperation.

Il existe quatre domaines principaux d'extensibilité de répartiteur exposés par la classe DispatchRuntime :

1. Les composants du répartiteur utilisent les propriétés de DispatchRuntime et celles du répartiteur de canal associé retournées par la propriété ChannelDispatcher pour personnaliser la façon dont le répartiteur de canal accepte et ferme des canaux. Cette catégorie inclut les propriétés ChannelInitializers et InputSessionShutdownHandlers.

2. Les composants de message sont personnalisés pour chaque message traité. Cette catégorie inclut les propriétés MessageInspectors, OperationSelector, Operations et ErrorHandlers.

3. Les composants d'instance personnalisent la création, la durée de vie et la suppression des instances du type de service. Pour plus d'informations sur la durée de vie de l'objet de service, consultez la propriété InstanceContextMode. Cette catégorie inclut les propriétés InstanceContextInitializers et InstanceProvider.

4. Les composants relatifs à la sécurité peuvent utiliser les propriétés suivantes :

   • SecurityAuditLogLocation indique où les événements d'audit sont écrits.

   • ImpersonateCallerForAllOperations contrôle si le service essaie d'emprunter l'identité à l'aide des informations d'identification fournies par le message entrant.

   • MessageAuthenticationAuditLevel contrôle si les événements d'authentification de message réussis sont écrits dans le journal des événements spécifié par SecurityAuditLogLocation.

   • PrincipalPermissionMode contrôle la façon dont la propriété CurrentPrincipal est définie.

   • ServiceAuthorizationAuditLevel spécifie comment l'audit d'événements d'autorisation est effectué.

   • SuppressAuditFailure spécifie s'il faut supprimer les exceptions non critiques qui se produisent pendant le processus d'enregistrement.

Généralement, des objets d'extension personnalisés sont affectés à une propriété DispatchRuntime ou insérés dans une collection par un comportement de service (un objet qui implémente IServiceBehavior), un comportement de contrat (un objet qui implémente IContractBehavior) ou un comportement de point de terminaison (un objet qui implémente IEndpointBehavior). Puis, l’objet de comportement installé est ajouté à la collection appropriée de comportements soit via le programme soit en implémentant un objet BehaviorExtensionElement personnalisé pour que le comportement soit inséré à l’aide d’un fichier de configuration d’application.

Propriétés

Méthodes

S’applique à