ClientRuntime Classe

Definizione

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

Ereditarietà

Object

ClientRuntime

Ereditarietà

Object

ClientRuntimeCompatBase

ClientRuntime

Esempio

Nell'esempio di codice seguente viene System.ServiceModel.Description.IEndpointBehavior inserito un oggetto System.ServiceModel.Dispatcher.IClientMessageInspector nel runtime client aggiungendolo alla MessageInspectors proprietà .

#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

L'esempio di codice seguente illustra un file di configurazione che carica il comportamento dell'endpoint nell'endpoint client.

  <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>

Commenti

Gli oggetti client WCF, che si tratti di un'estensione di ClientBase<TChannel> o di IClientChannel, vengono usati dalle applicazioni client windows Communication Foundation (WCF) per convertire le chiamate di metodo in messaggi in uscita e convertire i messaggi in ingresso in oggetti e passarli ai risultati dei metodi client.

La ClientRuntime classe è un punto di estendibilità a cui è possibile aggiungere oggetti di estensione che intercettano i messaggi ed estendono il comportamento del client in tutte le operazioni. Gli oggetti di intercettazione possono elaborare tutti i messaggi in un determinato contratto, elaborare solo i messaggi per determinate operazioni, eseguire l'inizializzazione del canale personalizzato e implementare altri comportamenti dell'applicazione client personalizzata. Per una panoramica dell'architettura client, vedere Architettura client WCF. Per altre informazioni sulla programmazione client, vedere Accesso ai servizi tramite un client WCF. Per informazioni dettagliate sulle personalizzazioni e su come eseguirle, vedere Estensione dei client.

• La CallbackDispatchRuntime proprietà restituisce l'oggetto runtime dispatch per le operazioni di callback avviate dal servizio.

• La OperationSelector proprietà accetta un oggetto selettore di operazioni personalizzato per controllare il routing dei messaggi client.

• La ChannelInitializers proprietà abilita l'aggiunta di un inizializzatore di canale in grado di esaminare o modificare il canale client.

• La InteractiveChannelInitializers proprietà può essere usata per visualizzare un prompt visivo per consentire a un utente di selezionare le credenziali prima di aprire il canale.

• La Operations proprietà ottiene una raccolta di ClientOperation oggetti a cui è possibile aggiungere intercettori di messaggi personalizzati che forniscono funzionalità specifiche per i messaggi di tale operazione.

• La proprietà ManualAddressing consente a un'applicazione di disattivare automaticamente alcune intestazioni di indirizzamento per poter controllare direttamente l'indirizzamento.

• La MaxFaultSize proprietà consente al client di limitare le dimensioni dei messaggi di errore accettati dal client.

• La MessageInspectors proprietà ottiene una raccolta di IClientMessageInspector oggetti a cui è possibile aggiungere intercettori di messaggi personalizzati per tutti i messaggi in viaggio attraverso un client.

• La UnhandledClientOperation proprietà restituisce l'operazione a cui vengono passati messaggi imprevisti.

• La ValidateMustUnderstand proprietà informa il sistema se deve confermare che le intestazioni SOAP contrassegnate come MustUnderstand sono state effettivamente comprese.

• La Via proprietà imposta il valore della destinazione del messaggio a livello di trasporto per supportare intermediari e altri scenari.

Inoltre, esistono diverse altre proprietà che recuperano le informazioni sul contratto client:

• ContractName

• ContractNamespace

• ContractClientType

Se il client è un client duplex, le proprietà seguenti recuperano anche il tipo di callback client e il runtime:

• CallbackClientType

• CallbackDispatchRuntime