IContractBehavior.ApplyClientBehavior Método

Referencia

Definición

Espacio de nombres:: System.ServiceModel.Description

Ensamblado:: System.ServiceModel.Primitives.dll

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Implementa una modificación o extensión del cliente en este contrato.

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)

Parámetros

contractDescription: ContractDescription

La descripción del contrato para el que se diseñó la extensión.

endpoint: ServiceEndpoint

punto de conexión.

clientRuntime: ClientRuntime

El tiempo de ejecución del cliente.

Ejemplos

El ejemplo de código siguiente supone que una implementación IInstanceProvider personalizada, llamada ObjectProviderBehavior, que proporciona un comportamiento "singleton", siempre devuelve la misma instancia del servicio y no lo recicla.

Para insertar la personalización del proveedor de instancias, el ejemplo muestra cómo implementar un atributo personalizado (SingletonBehaviorAttribute) que implementa IContractBehavior para insertar el proveedor de instancias del servicio personalizado. También implementa IContractBehaviorAttribute, que enlaza su utilización al contrato 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

Comentarios

Implemente el método ApplyClientBehavior para ver, modificar o agregar extensiones personalizadas al tiempo de ejecución del cliente en todos los mensajes o en una operación concreta. Para obtener información detallada acerca de las personalizaciones que puede realizar con un objeto de tiempo de ejecución del cliente, vea ClientRuntime y ClientOperation.

El método ApplyClientBehavior puede iniciar una excepción NotImplementedException si el comportamiento sólo puede utilizarse en una aplicación de servicio.

Se llama a este método una vez por cada extremo que utiliza el contrato de servicio especificado.

Tenga en cuenta que puede haber dos operaciones con el mismo nombre en la descripción (uno en cada dirección), por lo que si debe ejecutar una iteración en las operaciones con un contrato dúplex, tiene que asociar la dirección del mensaje entre el extremo ClientRuntime y la devuelta por la propiedad CallbackDispatchRuntime.

Dado que otros comportamientos pueden haber agregado o quitado algunas operaciones del tiempo de ejecución, no hay garantía de que exista el mismo número de operaciones en la descripción como objetos ClientOperation en la propiedad Operations.

Se aplica a

Compartir vía