EndpointDispatcher Classe

Définition

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

Propriétés

Méthodes

S’applique à