ClientRuntime Clase

Definición

public ref class ClientRuntime sealed

public ref class ClientRuntime sealed : System::ServiceModel::Dispatcher::ClientRuntimeCompatBase

public sealed class ClientRuntime

public sealed class ClientRuntime : System.ServiceModel.Dispatcher.ClientRuntimeCompatBase

type ClientRuntime = class

type ClientRuntime = class
    inherit ClientRuntimeCompatBase

Public NotInheritable Class ClientRuntime

Public NotInheritable Class ClientRuntime
Inherits ClientRuntimeCompatBase

Herencia

Object

ClientRuntime

Herencia

Object

ClientRuntimeCompatBase

ClientRuntime

Ejemplos

En el siguiente ejemplo de código, un objeto System.ServiceModel.Description.IEndpointBehavior inserta System.ServiceModel.Dispatcher.IClientMessageInspector en tiempo de ejecución del cliente agregándolo a la propiedad MessageInspectors.

#region IEndpointBehavior Members
public void AddBindingParameters(
  ServiceEndpoint endpoint, BindingParameterCollection bindingParameters
) { return; }

public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
{
  clientRuntime.MessageInspectors.Add(new Inspector());
  foreach (ClientOperation op in clientRuntime.Operations)
    op.ParameterInspectors.Add(new Inspector());
}

public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)
{
  endpointDispatcher.DispatchRuntime.MessageInspectors.Add(new Inspector());
  foreach (DispatchOperation op in endpointDispatcher.DispatchRuntime.Operations)
    op.ParameterInspectors.Add(new Inspector());
}

public void Validate(ServiceEndpoint endpoint){ return; }

#Region "IEndpointBehavior Members"
    Public Sub AddBindingParameters(ByVal endpoint As ServiceEndpoint, ByVal bindingParameters _
                                    As BindingParameterCollection) Implements IEndpointBehavior.AddBindingParameters
        Return
    End Sub

    Public Sub ApplyClientBehavior(ByVal endpoint As ServiceEndpoint, ByVal clientRuntime As ClientRuntime) _
    Implements IEndpointBehavior.ApplyClientBehavior
        clientRuntime.MessageInspectors.Add(New Inspector())
        For Each op As ClientOperation In clientRuntime.Operations
            op.ParameterInspectors.Add(New Inspector())
        Next op
    End Sub

    Public Sub ApplyDispatchBehavior(ByVal endpoint As ServiceEndpoint, ByVal endpointDispatcher As  _
                                     EndpointDispatcher) Implements IEndpointBehavior.ApplyDispatchBehavior
        endpointDispatcher.DispatchRuntime.MessageInspectors.Add(New Inspector())
        For Each op As DispatchOperation In endpointDispatcher.DispatchRuntime.Operations
            op.ParameterInspectors.Add(New Inspector())
        Next op
    End Sub

Public Sub Validate(ByVal endpoint As ServiceEndpoint) Implements IEndpointBehavior.Validate
    Return
End Sub

En el ejemplo de código siguiente se muestra un archivo de configuración que carga el comportamiento del punto de conexión en el punto de conexión del cliente.

  <client>
      <endpoint 
        address="http://localhost:8080/SampleService" 
        behaviorConfiguration="clientInspectorsAdded" 
        binding="wsHttpBinding"
        bindingConfiguration="WSHttpBinding_ISampleService" 
        contract="ISampleService"
        name="WSHttpBinding_ISampleService"
      >
      </endpoint>
  </client>
<behaviors>
  <endpointBehaviors>
    <behavior name="clientInspectorsAdded">
      <clientInterceptors />
    </behavior>
  </endpointBehaviors>
</behaviors>
<extensions>
  <behaviorExtensions>
    <add 
      name="clientInterceptors" 
      type="Microsoft.WCF.Documentation.InspectorInserter, HostApplication, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"
  />
  </behaviorExtensions>
</extensions>

Comentarios

Las aplicaciones cliente de Communication Foundation (WCF) Windows usan una extensión de ClientBase<TChannel> o de IClientChannel, para convertir llamadas de método en mensajes salientes y convertir mensajes entrantes en objetos y pasarlos a los resultados de los métodos de cliente.

La clase ClientRuntime es un punto de extensibilidad al que puede agregar objetos de extensión que interceptan los mensajes y extienden el comportamiento del cliente por todas las operaciones. Los objetos de interceptación pueden procesar todos los mensajes de un contrato determinado, procesar solo los mensajes para operaciones determinadas, realizar la inicialización personalizada de canales e implementar otro comportamiento de aplicación cliente personalizado. Para obtener información general sobre la arquitectura de cliente, consulte Arquitectura de cliente WCF. Para obtener más información sobre la programación de cliente, vea Acceso a servicios mediante un cliente WCF. Para obtener más información sobre las personalizaciones y cómo realizarlas, consulte Extensión de clientes.

• La propiedad CallbackDispatchRuntime devuelve el objeto en tiempo de ejecución de envío para las operaciones de devolución de llamada iniciadas por el servicio.

• La propiedad OperationSelector acepta un objeto de selector de operaciones personalizado para controlar el enrutamiento de mensajes del cliente.

• La propiedad ChannelInitializers habilita la adición de un inicializador de canales que puede inspeccionar o modificar el canal del cliente.

• La propiedad InteractiveChannelInitializers se puede utilizar para mostrar un indicador visual que permita al usuario seleccionar credenciales antes de abrir el canal.

• La propiedad Operations obtiene una colección de objetos ClientOperation a la que puede agregar interceptores de mensajes personalizados que proporcionan funcionalidad específica a los mensajes de esa operación.

• La propiedad ManualAddressing permite a una aplicación desactivar algunos encabezados de direccionamiento automáticos para controlar directamente el direccionamiento.

• La propiedad MaxFaultSize permite al cliente limitar el tamaño de los mensajes de error que acepta el cliente.

• La propiedad MessageInspectors obtiene una colección de objetos IClientMessageInspector a la que puede agregar interceptores de mensajes personalizados para todos los mensajes que se desplazan por un cliente.

• La propiedad UnhandledClientOperation devuelve la operación a la que se pasan los mensajes inesperados.

• La propiedad ValidateMustUnderstand informa al sistema sobre si debe confirmar que los encabezados SOAP marcados como MustUnderstand han sido, de hecho, entendidos.

• La propiedad Via establece el valor del destino del mensaje en el nivel de transporte para admitir intermediarios y otros escenarios.

Hay, además, otras varias propiedades que recuperan la información de contrato del cliente:

• ContractName

• ContractNamespace

• ContractClientType

Si el cliente es un cliente dúplex, las propiedades siguientes también recuperan el tipo de devolución de llamada y el tiempo de ejecución del cliente:

• CallbackClientType

• CallbackDispatchRuntime

Propiedades

Métodos

Se aplica a