IContractBehavior.ApplyDispatchBehavior Méthode

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Implémente une modification ou une extension du client sur l’intégralité d’un contrat.

public:
 void ApplyDispatchBehavior(System::ServiceModel::Description::ContractDescription ^ contractDescription, System::ServiceModel::Description::ServiceEndpoint ^ endpoint, System::ServiceModel::Dispatcher::DispatchRuntime ^ dispatchRuntime);

public void ApplyDispatchBehavior (System.ServiceModel.Description.ContractDescription contractDescription, System.ServiceModel.Description.ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.DispatchRuntime dispatchRuntime);

abstract member ApplyDispatchBehavior : System.ServiceModel.Description.ContractDescription * System.ServiceModel.Description.ServiceEndpoint * System.ServiceModel.Dispatcher.DispatchRuntime -> unit

Public Sub ApplyDispatchBehavior (contractDescription As ContractDescription, endpoint As ServiceEndpoint, dispatchRuntime As DispatchRuntime)

Paramètres

contractDescription

ContractDescription

Description de contrat à modifier.

endpoint

ServiceEndpoint

Point de terminaison qui expose le contrat.

dispatchRuntime

DispatchRuntime

Exécution de répartiteur qui contrôle l'exécution de service.

Exemples

L'exemple de code suivant suppose une implémentation IInstanceProvider personnalisée appelée ObjectProviderBehavior, qui fournit un comportement singleton ; elle retourne toujours la même instance de service et ne la recycle pas.

Pour personnaliser le fournisseur d'instances, l'exemple illustre l'implémentation d'un attribut personnalisé (SingletonBehaviorAttribute) qui implémente IContractBehavior pour insérer le fournisseur d'instances de services personnalisé. Il implémente également IContractBehaviorAttribute, qui lie son utilisation au contrat ISampleService.

public class SingletonBehaviorAttribute : Attribute, IContractBehaviorAttribute, IContractBehavior
{

  #region IContractBehaviorAttribute Members

  public Type TargetContract
  {
    get { return typeof(ISampleService); }
  }

  #endregion

  #region IContractBehavior Members

  public void AddBindingParameters(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection parameters)
  {
    return;
  }

  public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, ClientRuntime clientRuntime)
  {
    return;
  }

  public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, DispatchRuntime dispatch)
  {
    dispatch.InstanceProvider = new ObjectProviderBehavior("Custom ObjectProviderBehavior constructor.");
  }

  public void Validate(ContractDescription description, ServiceEndpoint endpoint)
  {
    return;
  }

  #endregion
}

Public Class SingletonBehaviorAttribute
    Inherits Attribute
    Implements IContractBehaviorAttribute, IContractBehavior

  #Region "IContractBehaviorAttribute Members"

  Public ReadOnly Property TargetContract() As Type Implements IContractBehaviorAttribute.TargetContract
    Get
        Return GetType(ISampleService)
    End Get
  End Property

  #End Region

  #Region "IContractBehavior Members"

  Public Sub AddBindingParameters(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal parameters As System.ServiceModel.Channels.BindingParameterCollection) Implements IContractBehavior.AddBindingParameters
    Return
  End Sub

  Public Sub ApplyClientBehavior(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal clientRuntime As ClientRuntime) Implements IContractBehavior.ApplyClientBehavior
    Return
  End Sub

  Public Sub ApplyDispatchBehavior(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal dispatch As DispatchRuntime) Implements IContractBehavior.ApplyDispatchBehavior
    dispatch.InstanceProvider = New ObjectProviderBehavior("Custom ObjectProviderBehavior constructor.")
  End Sub

  Public Sub Validate(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint) Implements IContractBehavior.Validate
    Return
  End Sub

  #End Region
End Class

Remarques

Implémentez l'ApplyDispatchBehavior pour afficher, modifier ou ajouter des extensions personnalisées à l'exécution de service sur l'intégralité des messages dans un contrat spécifique ou pour une opération spécifique de ce contrat. Pour plus d'informations sur les personnalisations que vous pouvez effectuer dans une application de service, consultez DispatchRuntime et DispatchOperation.

La méthode ApplyDispatchBehavior peut lever une exception NotImplementedException si le comportement est uniquement destiné à une utilisation dans une application cliente.

Cette méthode est appelée une fois pour chaque point de terminaison qui utilise le contrat de service spécifié.

Notez que deux opérations peuvent avoir le même nom dans la description (une dans chaque direction). Par conséquent, si vous devez itérer au sein des opérations dans lesquelles le contrat est un contrat duplex, vous devez corréler la direction de message entre le point de terminaison DispatchRuntime et celui retourné par la propriété CallbackClientRuntime.

De plus, étant donné que d'autres comportements ont peut-être déjà ajouté ou supprimé des opérations de l'exécution, rien ne garantit que le nombre d'opérations dans les descriptions soit similaire à celui des objets DispatchOperation dans la propriété Operations.