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 DispatchRuntime classe pour modifier le comportement par défaut d’un service ou d’un point de terminaison individuel, ou pour insérer des objets qui implémentent des modifications personnalisées dans un ou les deux processus de service suivants :

1. Transformation des messages entrants en objets et libération de ces objets sous forme d’appels de méthode sur un objet de service.

2. Transformation des objets reçus de la réponse à un appel d’opération de service en 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 des méthodes et d’appeler et de traiter les réponses. Chaque point de terminaison exposé par un ServiceHost objet a un répartiteur de point de terminaison et un répartiteur de canal associé ; en outre, chaque client participant à la communication duplex a également un répartiteur de point de terminaison et un répartiteur de canal pour chaque point de terminaison de rappel.

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

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

1. Les composants dispatch utilisent les propriétés du répartiteur de DispatchRuntime canal associé retourné par la ChannelDispatcher propriété pour personnaliser la façon dont le répartiteur de canal accepte et ferme les 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 MessageInspectors, OperationSelector, Operations et les ErrorHandlers propriétés.

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 les durées de vie des objets de service, consultez la propriété InstanceContextMode. Cette catégorie inclut les propriétés InstanceContextInitializers et InstanceProvider.

4. Les composants liés à 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 tente de se faire passer pour un autre en utilisant les informations d'identification fournies par le message entrant.

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

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

   • ServiceAuthorizationAuditLevel spécifie la façon dont l’audit des événements d’autorisation est effectué.

   • SuppressAuditFailure spécifie s’il faut supprimer les exceptions non critiques qui se produisent pendant le processus de journalisation.

En règle générale, les objets d’extension personnalisés sont affectés à une DispatchRuntime propriété ou insérés IServiceBehaviordans une collection par un comportement de service (objet qui implémente), un comportement de contrat (objet qui implémente IContractBehavior) ou un comportement de point de terminaison (un objet qui implémente IEndpointBehavior). Ensuite, l’objet de comportement d’installation est ajouté à la collection appropriée de comportements par programme ou en implémentant un objet personnalisé BehaviorExtensionElement pour permettre l’insertion du comportement à l’aide d’un fichier de configuration d’application.