IContractBehavior.ApplyDispatchBehavior Méthode

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

Exemples

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

Pour insérer la personnalisation du fournisseur d’instances, l’exemple montre comment implémenter un attribut personnalisé (SingletonBehaviorAttribute) qui implémente IContractBehavior pour insérer le fournisseur d’instance de service personnalisé. Il implémente IContractBehaviorAttributeégalement , qui lie son utilisation au ISampleService contrat.

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’affichage, la modification ou l’ajout ApplyDispatchBehavior d’extensions personnalisées au runtime de service sur tous les messages d’un contrat spécifique ou pour une opération spécifique dans ce contrat. Pour plus d’informations sur les personnalisations que vous pouvez effectuer dans une application de service, consultez DispatchRuntime et DispatchOperation.

La ApplyDispatchBehavior méthode peut lever une NotImplementedException exception si le comportement est destiné uniquement à être utilisé 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 qu’il peut y avoir deux opérations portant le même nom dans la description (une dans chaque direction), donc si vous devez effectuer une itération dans les opérations où le contrat est un contrat duplex, vous devez mettre en corrélation la direction du message entre le point de terminaison DispatchRuntime et celui retourné par la CallbackClientRuntime propriété.

En outre, étant donné que d’autres comportements ont peut-être déjà ajouté ou supprimé certaines opérations du runtime, il n’existe aucune garantie qu’il existe le même nombre d’opérations dans la description qu’il y DispatchOperation a des objets dans la Operations propriété.