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 a seguir usa a propriedade e Current o GetCallbackChannel método para obter o canal de volta para o chamador de dentro de um método. Todos os métodos neste exemplo são métodos unidirecionais, permitindo que o serviço e o cliente se comuniquem em ambas as direções de forma independente. Nesse caso, o aplicativo cliente de exemplo espera apenas uma chamada de retorno antes de sair, mas outro cliente, por exemplo, um cliente do 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 a seguir implementa a SampleDuplexHelloCallback mensagem de retorno de chamada para receber. O contrato de retorno de chamada importado não é o mesmo nome do serviço, devido ao uso da Name propriedade no exemplo anterior. Observe que o cliente não faz suposições sobre se ou quando pode receber um retorno de chamada; o retorno de chamada 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();
    }
  }
}

Comentários

Use o OperationContext de dentro de uma operação de serviço para acessar o ambiente de execução da operação atual. Em particular, o contexto de operação é usado para acessar canais de retorno de chamada em serviços duplex, armazenar dados de estado extras entre partes das operações e acessar cabeçalhos e propriedades de mensagens de entrada, bem como adicionar cabeçalhos e propriedades de mensagem de saída.

Para obter mais informações sobre como usar extensões para armazenar dados de estado, consulte Objetos Extensíveis.

Ele OperationContext tem as seguintes propriedades e métodos.

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

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

• A EndpointDispatcher propriedade obtém a operação.System.ServiceModel.Dispatcher.EndpointDispatcher

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

• A Host propriedade retorna o ServiceHostBase objeto que gerencia o serviço.

• A HasSupportingTokens propriedade retorna um valor que indica se o método tem tokens de suporte, se assim for, a propriedade os SupportingTokens obtém.

• As IncomingMessageHeaderspropriedades e IncomingMessageProperties as IncomingMessageVersionpropriedades obtêm esses itens da mensagem de entrada.

• O OperationCompleted evento é acionado quando a operação é concluída.

• As OutgoingMessageHeaders propriedades e as OutgoingMessageProperties propriedades obtêm esses itens para a mensagem de saída.

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

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

• A SessionId propriedade retorna o identificador de sessão para o canal e o objeto atuais.

• O GetCallbackChannel método retorna um canal de retorno de chamada para o chamador no caso de comunicação duplex.

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