EndpointDispatcher Classe

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Représente l’objet d’exécution qui expose les propriétés activant l’insertion d’extensions ou de modifications d’exécution pour les messages dans les applications de service.

public ref class EndpointDispatcher

public ref class EndpointDispatcher sealed

public class EndpointDispatcher

public sealed class EndpointDispatcher

type EndpointDispatcher = class

Public Class EndpointDispatcher

Public NotInheritable Class EndpointDispatcher

Héritage

Object

EndpointDispatcher

Exemples

L'exemple de code suivant présente l'utilisation du EndpointDispatcher pour localiser le System.ServiceModel.Dispatcher.DispatchRuntime pour le point de terminaison et insère un inspecteur de message personnalisé à l'aide d'un comportement de point de terminaison.

// IEndpointBehavior Members
public void AddBindingParameters(ServiceEndpoint serviceEndpoint, System.ServiceModel.Channels.BindingParameterCollection bindingParameters)
{
  return;
}

public void ApplyClientBehavior(ServiceEndpoint serviceEndpoint, ClientRuntime behavior)
{
  behavior.MessageInspectors.Add(new EndpointBehaviorMessageInspector());
}

public void ApplyDispatchBehavior(ServiceEndpoint serviceEndpoint, EndpointDispatcher endpointDispatcher)
{
  endpointDispatcher.DispatchRuntime.MessageInspectors.Add(new EndpointBehaviorMessageInspector());
}

public void Validate(ServiceEndpoint serviceEndpoint)
{
  return;
}

Remarques

Les classes EndpointDispatcher et System.ServiceModel.Dispatcher.DispatchRuntime exposent les points de personnalisation d'exécution pour les points de terminaison dans un service. EndpointDispatcher peut être utilisé pour contrôler les messages qu'il peut traiter et quelques informations relatives au point de terminaison. L’élément DispatchRuntime a un grand nombre de propriétés utilisées pour insérer des extensions personnalisées dans l’exécution au niveau du point de terminaison.

L'objet EndpointDispatcher est chargé du traitement des messages à partir d'un System.ServiceModel.Dispatcher.ChannelDispatcher lorsque l'adresse de destination d'un message correspond à la propriété AddressFilter et que l'action de message correspond à la propriété ContractFilter. Si deux objets EndpointDispatcher peuvent accepter un message, la valeur de la propriété FilterPriority détermine le point de terminaison dont la priorité est la plus élevée.

Utilisez l'objet EndpointDispatcher pour configurer ou étendre le processus de réception de messages du ChannelDispatcher associé, la conversion d'objets de message en objets utilisés comme paramètres et l'appel d'une opération de point de terminaison aussi bien que le processus inverse.

En général, le EndpointDispatcher pour un point de terminaison est obtenu en implémentant l'interface IEndpointBehavior, mais vous pouvez accéder au EndpointDispatcher à partir d'autres interfaces de comportement.

Vous pouvez utiliser les propriétés EndpointDispatcher suivantes :

• La propriété AddressFilter vous permet d'obtenir ou de définir un objet MessageFilter que le ChannelDispatcher utilise pour identifier si le point de terminaison peut traiter un message particulier.

• La propriété ChannelDispatcher obtient l'objet ChannelDispatcher associé, qui envoie à et reçoit des messages du EndpointDispatcher et qui peut être utilisé pour inspecter ou modifier d'autres valeurs et comportements liés au canal.

• Le ContractFilter obtient l'objet MessageFilter utilisé pour identifier si un message est destiné à ce contrat.

• Les propriétés ContractName et ContractNamespace retournent le nom et l'espace de noms du contrat de point de terminaison.

• La propriété DispatchRuntime retourne l’objet DispatchRuntime que vous pouvez utiliser pour modifier des valeurs d’exécution ou insérer des extensions d’exécution personnalisées pour la totalité du point de terminaison.

• La propriété EndpointAddress obtient l'adresse du point de terminaison.

• La propriété FilterPriority retourne la priorité du filtre composite que le ChannelDispatcher utilise pour établir quel point de terminaison doit gérer le message.

Constructeurs

EndpointDispatcher(EndpointAddress, String, String)	Initialise une nouvelle instance de la classe EndpointDispatcher à l'aide de l'adresse, du nom de contrat et de l'espace de noms de contrat spécifiés.
EndpointDispatcher(EndpointAddress, String, String, Boolean)	Initialise une nouvelle instance de la classe EndpointDispatcher avec l'adresse spécifiée, nom de contrat, espace de noms de contrat, et si le point de terminaison est un public, point de terminaison de système.

Propriétés

AddressFilter	Obtient ou définit un objet MessageFilter utilisé pour identifier si un message particulier est destiné à l'adresse de point de terminaison.
ChannelDispatcher	Obtient l'objet ChannelDispatcher associé, qui peut être utilisé pour inspecter ou modifier d'autres valeurs et comportements liés au canal.
ContractFilter	Obtient ou définit l'objet MessageFilter utilisé pour identifier si un message est destiné à ce contrat.
ContractName	Obtient le nom du contrat de point de terminaison.
ContractNamespace	Obtient l'espace de noms du contrat de point de terminaison.
DispatchRuntime	Obtient l'objet DispatchRuntime utilisé pour inspecter, modifier ou étendre le comportement d'exécution dans l'ensemble d'un point de terminaison de service ou d'un point de terminaison de rappel client.
EndpointAddress	Obtient l'adresse du point de terminaison.
FilterPriority	Obtient ou définit la priorité de la combinaison du ContractFilter et du AddressFilter lorsque le ChannelDispatcher sélectionne des points de terminaison.
IsSystemEndpoint	Obtient une valeur qui indique si le point de terminaison est créé en interne par le serveur et non pas par l’utilisateur.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)