IContractBehavior.ApplyDispatchBehavior Methode

Definition

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Implementiert eine Änderung oder eine Erweiterung des Clients in einem gesamten Vertrag.

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)

Parameter

contractDescription

ContractDescription

Die zu ändernde Vertragsbeschreibung.

endpoint

ServiceEndpoint

Der Endpunkt, der den Vertrag verfügbar macht.

dispatchRuntime

DispatchRuntime

Die Dispatchlaufzeit, die die Dienstausführung steuert.

Beispiele

Im folgenden Codebeispiel wird von einer benutzerdefinierten IInstanceProvider-Implementierung mit der Bezeichnung ObjectProviderBehavior ausgegangen, die ein Singletonverhalten ermöglicht; dabei wird stets die gleiche Dienstinstanz zurückgegeben und nicht wiederverwendet.

Zum Einfügen der Instanzanbieteranpassung wird in dem Beispiel die Implementierung eines benutzerdefinierten Attributs (SingletonBehaviorAttribute) veranschaulicht, das IContractBehavior implementiert, um den benutzerdefinierten Instanzanbieter des Diensts einzufügen. Es implementiert auch IContractBehaviorAttribute, wodurch dessen Verwendung an den ISampleService-Vertrag gebunden wird.

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

Hinweise

Implementieren Sie den ApplyDispatchBehavior, um in allen Meldungen eines bestimmten Vertrags oder für einen bestimmten Vorgang in diesem Vertrag benutzerdefinierte Erweiterungen zur Dienstlaufzeit anzuzeigen, zu ändern oder hinzuzufügen. Ausführliche Informationen über Anpassungsmöglichkeiten in Dienstanwendungen finden Sie unter DispatchRuntime und DispatchOperation.

Die ApplyDispatchBehavior-Methode kann eine NotImplementedException-Ausnahme auslösen, wenn das Verhalten nur zur Verwendung in einer Clientanwendung vorgesehen ist.

Diese Methode wird einmal für jeden Endpunkt aufgerufen, der den angegebenen Dienstvertrag verwendet.

Beachten Sie, dass es zwei Vorgänge mit demselben Namen in der Beschreibung (einen pro Richtung) geben kann; wenn Sie daher Vorgänge durchlaufen müssen, bei denen der Vertrag ein Duplexvertrag ist, müssen Sie die Richtung der Meldung zwischen dem Endpunkt DispatchRuntime und dem von der CallbackClientRuntime-Eigenschaft zurückgegebenen Endpunkt in Beziehung setzen.

Da andere Verhalten unter Umständen bereits einige Vorgänge hinzugefügt oder aus der Laufzeit entfernt haben, ist zudem nicht gewährleistet, dass die Anzahl der in der Beschreibung enthaltenen Vorgänge mit der Anzahl der DispatchOperation-Objekte, die in der Operations-Eigenschaft enthalten sind, übereinstimmt.