OperationContext Clase

Definición

Espacio de nombres:

System.ServiceModel

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v8.1.1

Source:

OperationContext.cs

Proporciona acceso al contexto de ejecución de un método de servicio.

C#

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

Herencia

Object

OperationContext

Implementaciones

IExtensibleObject<OperationContext>

Ejemplos

En el ejemplo de código siguiente se usa la propiedad y GetCallbackChannel el Current método para obtener el canal de vuelta al autor de la llamada desde dentro de un método . Todos los métodos en este ejemplo son unidireccionales, lo que permite que el servicio y el cliente se comuniquen en ambas direcciones de manera independiente. En este caso, la aplicación cliente de ejemplo espera sólo una llamada de devolución antes de salir, pero otro cliente; por ejemplo, un cliente de Windows Forms, puede recibir cualquier número de llamadas desde el servicio.

C#

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);
    }
  }
}

El siguiente cliente implementa para SampleDuplexHelloCallback recibir el mensaje de devolución de llamada. El contrato de devolución de llamada importado no es el mismo nombre que el del servicio, debido al uso de la Name propiedad en el ejemplo anterior. Observe que el cliente no hace ninguna suposición sobre si podría recibir una devolución de llamada o cuándo; la devolución de llamada del servidor es completamente independiente de la llamada saliente del cliente.

Nota

Para obtener un ejemplo que usa la OperationContext clase en un escenario de cliente, vea OperationContextScope.

C#

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();
    }
  }
}

Comentarios

Use desde OperationContext dentro de una operación de servicio para acceder al entorno de ejecución de la operación actual. En particular, el contexto de la operación se utiliza para tener acceso a los canales de devolución de llamada en servicios dúplex, almacenar datos de estado adicionales en partes de las operaciones, y para tener acceso a los encabezados de mensaje entrante y propiedades así como agregar encabezados de mensajes salientes y propiedades.

Para obtener más información sobre el uso de extensiones para almacenar datos de estado, vea Objetos extensibles.

OperationContext tiene las siguientes propiedades y métodos.

• La Current propiedad devuelve el OperationContext objeto que representa el contexto de ejecución actual.

• La ServiceSecurityContext propiedad devuelve el entorno de seguridad en el que se ejecuta el método .

• La EndpointDispatcher propiedad obtiene el objeto de System.ServiceModel.Dispatcher.EndpointDispatcherla operación.

• La Extensions propiedad devuelve una colección de extensiones para el objeto actual OperationContext.

• La Host propiedad devuelve el ServiceHostBase objeto que administra el servicio.

• La HasSupportingTokens propiedad devuelve un valor que indica si el método tiene tokens auxiliares, si es así, la SupportingTokens propiedad las obtiene.

• Las IncomingMessageHeaderspropiedades , IncomingMessagePropertiesy IncomingMessageVersion obtienen estos elementos del mensaje entrante.

• El OperationCompleted evento se desencadena cuando se ha completado la operación.

• Las OutgoingMessageHeaders propiedades y OutgoingMessageProperties obtienen estos elementos para el mensaje saliente.

• La RequestContext propiedad devuelve la RequestContext implementación del método .

• La InstanceContext propiedad devuelve el InstanceContext asociado a la operación.

• La SessionId propiedad devuelve el identificador de sesión para el canal y el objeto actuales.

• El GetCallbackChannel método devuelve un canal de devolución de llamada al autor de la llamada en el caso de la comunicación dúplex.

• El SetTransactionComplete método confirma la transacción actual.

Constructores

OperationContext(IContextChannel)

Inicializa una nueva instancia de la clase OperationContext que usa el IContextChannel especificado en una aplicación cliente.

Propiedades

Channel	Obtiene el canal asociado con el objeto OperationContext actual.
Current	Obtiene o define el contexto de ejecución del subproceso actual.
Extensions	Recibe la colección de extensiones de servicio desde el contexto del mensaje actual.
IncomingMessageHeaders	Obtiene los encabezados de mensaje entrante para OperationContext.
IncomingMessageProperties	Obtiene las propiedades de mensaje para el mensaje entrante en OperationContext.
IncomingMessageVersion	Obtiene la versión del mensaje SOAP entrante para OperationContext.
IsUserContext	Esta propiedad está pensada para su uso por el sistema y los usuarios no deberían recurrir a ella.
OutgoingMessageHeaders	Obtiene los encabezados de mensajes salientes para el OperationContext activo.
OutgoingMessageProperties	Obtiene las propiedades del mensaje para el mensaje saliente en el OperationContext activo.
RequestContext	Obtiene o define la implementación de RequestContext para este método.

Métodos

GetCallbackChannel<T>()

Obtiene un canal a la instancia del cliente que haya llamado a la operación actual.

Eventos

OperationCompleted

Se produce cuando se ha completado la operación.

Se aplica a