OperationContext Klasse

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.1.1

Quelle:

OperationContext.cs

Bietet Zugriff auf den Ausführungskontext einer Dienstmethode.

C#

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

Vererbung

Object

OperationContext

Implementiert

IExtensibleObject<OperationContext>

Beispiele

Im folgenden Codebeispiel werden die Current -Eigenschaft und GetCallbackChannel -Methode verwendet, um den Kanal aus einer -Methode zurück an den Aufrufer abzurufen. Alle in diesem Beispiel verwendeten Methoden sind unidirektionale Methoden, die für den Dienst und den Client eine unabhängige Kommunikation in beide Richtungen ermöglichen. In diesem Fall erwartet die Beispielclientanwendung nur einen Rückgabeaufruf, bevor er beendet wird. Ein anderer Client, wie zum Beispiel ein Windows Forms-Client kann jedoch eine beliebige Anzahl Aufrufe von dem Dienst erhalten.

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

Der folgende Client implementiert den SampleDuplexHelloCallback , um die Rückrufnachricht zu empfangen. Der importierte Rückrufvertrag hat aufgrund der Verwendung der Eigenschaft im vorherigen Beispiel nicht den gleichen Namen wie der Name im Dienst. Beachten Sie, dass der Client keine Annahmen trifft, ob oder wann er einen Rückruf erhalten könnte. Der Serverrückruf ist völlig unabhängig vom ausgehenden Aufruf des Clients.

Hinweis

Ein Beispiel, das die OperationContext -Klasse in einem Clientszenario verwendet, finden Sie unter 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();
    }
  }
}

Hinweise

Verwenden Sie die OperationContext von innerhalb eines Dienstvorgangs, um auf die aktuelle Ausführungsumgebung des Vorgangs zuzugreifen. Der Vorgangskontext wird insbesondere für den Zugriff auf Rückrufkanal in Duplexdiensten eingesetzt, um zusätzliche Statusdaten für verschiedene Vorgangsbereiche zu speichern und auf eingehende Nachrichtenheader und -eigenschaften zuzugreifen sowie um ausgehende Nachrichtenheader und -eigenschaften hinzuzufügen.

Weitere Informationen zur Verwendung von Erweiterungen zum Speichern von Zustandsdaten finden Sie unter Erweiterbare Objekte.

Verfügt OperationContext über die folgenden Eigenschaften und Methoden.

• Die Current -Eigenschaft gibt das Objekt zurück, das OperationContext den aktuellen Ausführungskontext darstellt.

• Die ServiceSecurityContext -Eigenschaft gibt die Sicherheitsumgebung zurück, in der die -Methode ausgeführt wird.

• Die EndpointDispatcher -Eigenschaft ruft das -Objekt des Vorgangs ab System.ServiceModel.Dispatcher.EndpointDispatcher.

• Die Extensions -Eigenschaft gibt eine Erweiterungsauflistung für den aktuellen OperationContextzurück.

• Die Host -Eigenschaft gibt das ServiceHostBase -Objekt zurück, das den Dienst verwaltet.

• Die HasSupportingTokens -Eigenschaft gibt einen Wert zurück, der angibt, ob die Methode über unterstützende Token verfügt. Wenn ja, ruft die SupportingTokens -Eigenschaft diese ab.

• Die IncomingMessageHeadersEigenschaften , IncomingMessagePropertiesund IncomingMessageVersion rufen diese Elemente aus der eingehenden Nachricht ab.

• Das OperationCompleted Ereignis wird ausgelöst, wenn der Vorgang abgeschlossen ist.

• Die OutgoingMessageHeaders Eigenschaften und OutgoingMessageProperties rufen diese Elemente für die ausgehende Nachricht ab.

• Die RequestContext -Eigenschaft gibt die RequestContext Implementierung für die -Methode zurück.

• Die InstanceContext -Eigenschaft gibt das zurück, das InstanceContext dem Vorgang zugeordnet ist.

• Die SessionId -Eigenschaft gibt den Sitzungsbezeichner für den aktuellen Kanal und das aktuelle Objekt zurück.

• Die GetCallbackChannel -Methode gibt im Fall der Duplexkommunikation einen Rückrufkanal an den Aufrufer zurück.

• Die SetTransactionComplete -Methode committ die aktuelle Transaktion.

Konstruktoren

OperationContext(IContextChannel)

Initialisiert eine neue Instanz der OperationContext-Klasse, die den angegebenen IContextChannel in einer Clientanwendung verwendet.

Eigenschaften

Channel	Ruft den dem aktuellen OperationContext-Objekt zugeordneten Kanal ab.
Current	Ruft den Ausführungskontext für den aktuellen Thread ab oder legt ihn fest.
Extensions	Ruft die Diensterweiterungsauflistung vom aktuellen Nachrichtenkontext ab.
IncomingMessageHeaders	Ruft die eingehenden Nachrichtenheader für den OperationContext ab.
IncomingMessageProperties	Ruft die Nachrichteneigenschaften für die eingehende Nachricht im OperationContext ab.
IncomingMessageVersion	Ruft die eingehende SOAP-Nachrichtenversion für den OperationContext ab.
IsUserContext	Diese Eigenschaft ist zur Verwendung durch das System bestimmt und sollte nicht von Benutzern aufgerufen werden.
OutgoingMessageHeaders	Ruft die ausgehenden Nachrichtenheader für den aktiven OperationContext ab.
OutgoingMessageProperties	Ruft die Nachrichteneigenschaften für die ausgehende Nachricht im aktiven OperationContext ab.
RequestContext	Ruft die RequestContext-Implementierung für diese Methode ab oder legt sie fest.

Methoden

GetCallbackChannel<T>()

Ruft einen Kanal zur Clientinstanz ab, die den aktuellen Vorgang aufgerufen hat.

Ereignisse

OperationCompleted

Tritt ein, wenn der Vorgang abgeschlossen wurde.

Gilt für: