OperationContext Classe

Définition

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)

Héritage

Object

OperationContext

Implémente

IExtensibleObject<OperationContext>

Exemples

L’exemple de code suivant utilise la propriété et Current la GetCallbackChannel méthode pour récupérer le canal à l’appelant à partir d’une méthode. Toutes les méthodes de cet exemple sont des méthodes unidirectionnelle, ce qui permet au service et au client de communiquer indépendamment dans les deux sens. Dans ce cas, l’exemple d’application cliente attend un seul appel de retour avant de quitter, mais un autre client, par exemple un client Windows Forms, peut recevoir n’importe quel nombre d’appels du service.

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

Le client suivant implémente le SampleDuplexHelloCallback message de rappel pour recevoir le message de rappel. Le contrat de rappel importé n’est pas le même nom que celui du service, en raison de l’utilisation de la Name propriété dans l’exemple précédent. Notez que le client ne fait aucune hypothèse quant à la réception ou non d’un rappel ; le rappel de serveur est entièrement indépendant de l’appel sortant du client.

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

Remarques

Utilisez l’élément OperationContext à partir d’une opération de service pour accéder à l’environnement d’exécution de l’opération en cours. En particulier, le contexte d’opération est utilisé pour accéder aux canaux de rappel dans les services duplex, pour stocker des données d’état supplémentaires dans des parties des opérations, et pour accéder aux en-têtes et propriétés de message entrants, ainsi qu’à ajouter des en-têtes de message sortants et des propriétés.

Pour plus d’informations sur l’utilisation d’extensions pour stocker des données d’état, consultez Extensible Objects.

Les OperationContext propriétés et méthodes suivantes sont disponibles.

• La Current propriété retourne l’objet OperationContext représentant le contexte d’exécution actuel.

• La ServiceSecurityContext propriété retourne l’environnement de sécurité sous lequel la méthode s’exécute.

• La EndpointDispatcher propriété obtient l’opération System.ServiceModel.Dispatcher.EndpointDispatcher.

• La Extensions propriété retourne une collection d’extensions pour le fichier actif OperationContext.

• La Host propriété retourne l’objet ServiceHostBase qui gère le service.

• La HasSupportingTokens propriété retourne une valeur qui indique si la méthode a des jetons de prise en charge, le cas échéant, la SupportingTokens propriété les obtient.

• Les IncomingMessageHeaderspropriétés et IncomingMessageProperties les IncomingMessageVersionpropriétés obtiennent ces éléments à partir du message entrant.

• L’événement OperationCompleted est déclenché lorsque l’opération est terminée.

• Les OutgoingMessageHeaders propriétés obtiennent OutgoingMessageProperties ces éléments pour le message sortant.

• La RequestContext propriété retourne l’implémentation RequestContext de la méthode.

• La InstanceContext propriété retourne l’associé InstanceContext à l’opération.

• La SessionId propriété retourne l’identificateur de session pour le canal et l’objet actuels.

• La GetCallbackChannel méthode retourne un canal de rappel à l’appelant dans le cas d’une communication duplex.

• La SetTransactionComplete méthode valide la transaction actuelle.