OperationContext Classe

Definição

public ref class OperationContext sealed : System::ServiceModel::IExtensibleObject<System::ServiceModel::OperationContext ^>

public sealed class OperationContext : System.ServiceModel.IExtensibleObject<System.ServiceModel.OperationContext>

type OperationContext = class
    interface IExtensibleObject<OperationContext>

Public NotInheritable Class OperationContext
Implements IExtensibleObject(Of OperationContext)

Herança

Object

OperationContext

Implementações

IExtensibleObject<OperationContext>

Exemplos

O exemplo de código seguinte utiliza a propriedade e Current o GetCallbackChannel método para obter o canal de volta ao chamador a partir de dentro de um método. Todos os métodos neste exemplo são unidirecionais, permitindo que o serviço e o cliente comuniquem em ambas as direções de forma independente. Neste caso, a aplicação cliente de exemplo espera apenas uma chamada de retorno antes de sair, mas outro cliente, por exemplo um cliente Windows Forms, pode receber qualquer número de chamadas do serviço.

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(
    Name = "SampleDuplexHello",
    Namespace = "http://microsoft.wcf.documentation",
    CallbackContract = typeof(IHelloCallbackContract),
    SessionMode = SessionMode.Required
  )]
  public interface IDuplexHello
  {
    [OperationContract(IsOneWay = true)]
    void Hello(string greeting);
  }

  public interface IHelloCallbackContract
  {
    [OperationContract(IsOneWay = true)]
    void Reply(string responseToGreeting);
  }

  public class DuplexHello : IDuplexHello
  {
    public DuplexHello()
    {
      Console.WriteLine("Service object created: " + this.GetHashCode().ToString());
    }

    ~DuplexHello()
    {
      Console.WriteLine("Service object destroyed: " + this.GetHashCode().ToString());
    }

    public void Hello(string greeting)
    {
      Console.WriteLine("Caller sent: " + greeting);
      Console.WriteLine("Session ID: " + OperationContext.Current.SessionId);
      Console.WriteLine("Waiting two seconds before returning call.");
      // Put a slight delay to demonstrate asynchronous behavior on client.
      Thread.Sleep(2000);
      IHelloCallbackContract callerProxy
        = OperationContext.Current.GetCallbackChannel<IHelloCallbackContract>();
      string response = "Service object " + this.GetHashCode().ToString() + " received: " + greeting;
      Console.WriteLine("Sending back: " + response);
      callerProxy.Reply(response);
    }
  }
}

O cliente seguinte implementa a SampleDuplexHelloCallback mensagem para receber a chamada de retorno. O contrato de callback importado não tem o mesmo nome do do serviço, devido à utilização da Name propriedade no exemplo anterior. Note-se que o cliente não faz suposições sobre se ou quando poderá receber uma chamada de retorno; O callback do servidor é totalmente independente da chamada de saída do cliente.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  public class Client : SampleDuplexHelloCallback
  {
    AutoResetEvent waitHandle;

    public Client()
    {
      waitHandle = new AutoResetEvent(false);
    }

    public void Run()
    {
      // Picks up configuration from the config file.
      SampleDuplexHelloClient wcfClient
        = new SampleDuplexHelloClient(new InstanceContext(this));
      try
      {
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Enter a greeting to send and press ENTER: ");
        Console.Write(">>> ");
        Console.ForegroundColor = ConsoleColor.Green;
        string greeting = Console.ReadLine();
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Called service with: \r\n\t" + greeting);
        wcfClient.Hello(greeting);
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.");
        this.waitHandle.WaitOne();
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.WriteLine("Set was called.");
        Console.Write("Press ");
        Console.ForegroundColor = ConsoleColor.Red;
        Console.Write("ENTER");
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.Write(" to exit...");
        Console.ReadLine();
        wcfClient.Close();
      }
      catch (TimeoutException timeProblem)
      {
        Console.WriteLine("The service operation timed out. " + timeProblem.Message);
        Console.ReadLine();
        wcfClient.Abort();
      }
      catch (CommunicationException commProblem)
      {
        Console.WriteLine("There was a communication problem. " + commProblem.Message);
        Console.ReadLine();
        wcfClient.Abort();
      }
    }

    public static void Main()
    {
      Client client = new Client();
      client.Run();
    }

    public void Reply(string response)
    {
      Console.WriteLine("Received output.");
      Console.WriteLine("\r\n\t" + response);
      this.waitHandle.Set();
    }
  }
}

Observações

Use o OperationContext a partir de dentro de uma operação de serviço para aceder ao ambiente atual de execução da operação. Em particular, o contexto operacional é usado para aceder a canais de callback em serviços duplex, armazenar dados de estado extra em partes das operações, aceder aos cabeçalhos e propriedades das mensagens recebidas, bem como adicionar cabeçalhos e propriedades das mensagens de saída.

Para mais informações sobre o uso de extensões para armazenar dados de estado, veja Objetos Extensíveis.

O OperationContext possui as seguintes propriedades e métodos.

• A Current propriedade devolve o OperationContext objeto que representa o contexto de execução atual.

• A ServiceSecurityContext propriedade devolve o ambiente de segurança sob o qual o método é executado.

• A EndpointDispatcher propriedade recebe a System.ServiceModel.Dispatcher.EndpointDispatcheroperação .

• A Extensions propriedade devolve uma coleção de extensões para o atual OperationContext.

• A Host propriedade devolve o ServiceHostBase objeto que gere o serviço.

• A HasSupportingTokens propriedade devolve um valor que indica se o método tem tokens de suporte; em caso afirmativo, a SupportingTokens propriedade recebe-os.

• As IncomingMessageHeaderspropriedades , IncomingMessageProperties, e IncomingMessageVersion obtêm estes itens da mensagem recebida.

• O OperationCompleted evento é acionado quando a operação termina.

• As OutgoingMessageHeaders propriedades e OutgoingMessageProperties recebem estes itens para a mensagem de saída.

• A RequestContext propriedade devolve a RequestContext implementação do método.

• A InstanceContext propriedade devolve o associado InstanceContext à operação.

• A SessionId propriedade devolve o identificador de sessão para o canal e objeto correntes.

• O GetCallbackChannel método devolve um canal de chamada ao chamador no caso de comunicação duplex.

• O SetTransactionComplete método compromete a transação atual.