IContractBehavior.ApplyClientBehavior 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 ApplyClientBehavior(System::ServiceModel::Description::ContractDescription ^ contractDescription, System::ServiceModel::Description::ServiceEndpoint ^ endpoint, System::ServiceModel::Dispatcher::ClientRuntime ^ clientRuntime);

public void ApplyClientBehavior (System.ServiceModel.Description.ContractDescription contractDescription, System.ServiceModel.Description.ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.ClientRuntime clientRuntime);

abstract member ApplyClientBehavior : System.ServiceModel.Description.ContractDescription * System.ServiceModel.Description.ServiceEndpoint * System.ServiceModel.Dispatcher.ClientRuntime -> unit

Public Sub ApplyClientBehavior (contractDescription As ContractDescription, endpoint As ServiceEndpoint, clientRuntime As ClientRuntime)

Parameter

contractDescription

ContractDescription

Die Vertragsbeschreibung, für die die Erweiterung vorgesehen ist.

endpoint

ServiceEndpoint

Der Endpunkt.

clientRuntime

ClientRuntime

Die Clientlaufzeit.

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 die ApplyClientBehavior-Methode, um in allen Meldungen oder für einen bestimmten Vorgang benutzerdefinierte Erweiterungen zur Clientlaufzeit anzuzeigen, zu ändern oder hinzuzufügen. Ausführliche Informationen über Anpassungsmöglichkeiten bei Clientlaufzeitobjekten finden Sie unter ClientRuntime und ClientOperation.

Die ApplyClientBehavior-Methode kann eine NotImplementedException-Ausnahme auslösen, wenn das Verhalten nur zur Verwendung in einer Dienstanwendung 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 ClientRuntime und dem von der CallbackDispatchRuntime-Eigenschaft zurückgegebenen Endpunkt in Beziehung setzen.

Da andere Verhaltensweisen bereits einige Verfahren hinzugefügt oder aus der Laufzeit entfernt haben könnten, ist nicht gewährleistet, dass die Anzahl der in der Beschreibung enthaltenen Vorgänge mit der Anzahl der ClientOperation-Objekte, die in der Operations-Eigenschaft enthalten sind, übereinstimmt.