ClientRuntime Classe

Definição

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

Herança

Object

ClientRuntime

Herança

Object

ClientRuntimeCompatBase

ClientRuntime

Exemplos

No exemplo de código seguinte, insere-se System.ServiceModel.Description.IEndpointBehavior a System.ServiceModel.Dispatcher.IClientMessageInspector no runtime do cliente adicionando-o à MessageInspectors propriedade.

#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

O exemplo de código seguinte mostra um ficheiro de configuração que carrega o comportamento do endpoint no endpoint do 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>

Observações

Os objetos cliente WCF, sejam eles uma extensão de ClientBase<TChannel> ou de IClientChannel, são usados por aplicações cliente Windows Communication Foundation (WCF) para converter chamadas de método em mensagens de saída e converter mensagens recebidas em objetos, passando-as aos resultados dos métodos cliente.

A ClientRuntime classe é um ponto de extensibilidade ao qual pode adicionar objetos de extensão que intercetam mensagens e estendem o comportamento do cliente em todas as operações. Os objetos de intercetação podem processar todas as mensagens em um contrato específico, processar apenas mensagens para operações específicas, executar inicialização de canal personalizado e implementar outro comportamento de aplicativo cliente personalizado. Para uma visão geral da arquitetura do cliente, veja Arquitetura do Cliente WCF. Para mais informações sobre programação de clientes, consulte Aceder a Serviços Usando um Cliente WCF. Para detalhes sobre personalizações e como as realizar, consulte Extensão de Clientes.

• A CallbackDispatchRuntime propriedade devolve o objeto de execução de despacho para operações de callback iniciadas pelo serviço.

• A OperationSelector propriedade aceita um objeto seletor de operações personalizado para controlar o encaminhamento das mensagens do cliente.

• A ChannelInitializers propriedade permite a adição de um inicializador de canal que pode inspecionar ou modificar o canal do cliente.

• A InteractiveChannelInitializers propriedade pode ser usada para mostrar um prompt visual que permita ao utilizador selecionar credenciais antes de abrir o canal.

• A propriedade Operations obtém uma coleção de objetos aos quais podem ser adicionados intercetadores personalizados de mensagens ClientOperation, que fornecem funcionalidade específica para as mensagens da operação.

• A ManualAddressing propriedade permite que um aplicativo desative alguns cabeçalhos de endereçamento automático para controlar diretamente o endereçamento.

• Esta MaxFaultSize propriedade permite ao cliente limitar o tamanho das mensagens de falha que o cliente aceita.

• A MessageInspectors propriedade recebe uma coleção de IClientMessageInspector objetos aos quais pode adicionar interceptores de mensagens personalizados para todas as mensagens que viajam através de um cliente.

• A UnhandledClientOperation propriedade devolve a operação para a qual são passadas mensagens inesperadas.

• A ValidateMustUnderstand propriedade informa o sistema se deve confirmar que os cabeçalhos SOAP marcados como MustUnderstand terão, de facto, sido compreendidos.

• A Via propriedade define o valor do destino da mensagem no nível de transporte para oferecer suporte a intermediários e outros cenários.

Além disso, existem várias outras propriedades que recuperam a informação do contrato do cliente:

• ContractName

• ContractNamespace

• ContractClientType

Se o cliente for um cliente duplex, as seguintes propriedades também recuperam o tipo de callback e o tempo de execução do cliente:

• CallbackClientType

• CallbackDispatchRuntime