OperationContext 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.1.1

來源:

OperationContext.cs

提供服務方法執行內容的存取。

C#

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

繼承

Object

OperationContext

實作

IExtensibleObject<OperationContext>

範例

下列程式碼範例會 Current 使用 屬性和 GetCallbackChannel 方法，從 方法內取得呼叫端的通道。 本範例的所有方法都是單向方法，可讓服務與用戶端獨立地進行雙向通訊。 在此情況下，範例用戶端應用程式在結束前只預期一個傳回呼叫，但另一個用戶端，例如Windows Forms用戶端可以從服務接收任意數目的呼叫。

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

下列用戶端會實作 SampleDuplexHelloCallback 來接收回呼訊息。 由於使用上述範例中的 屬性， Name 匯入的回呼合約與服務中的回呼合約名稱不同。 注意，用戶端並沒有針對是否接收到回呼，或何時接收到回呼作任何的假設；伺服器回呼與用戶端的傳出呼叫完全無關。

備註

如需在 OperationContext 用戶端案例中使用 類別的範例，請參閱 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();
    }
  }
}

備註

OperationContext使用服務作業內的 來存取目前的作業執行環境。 作業內容特別用來存取雙工服務中的回呼通道、儲存作業各部分的額外狀態資料、存取傳入訊息標頭與屬性，以及新增傳出訊息標頭與屬性。

如需使用擴充功能來儲存狀態資料的詳細資訊，請參閱 可延伸物件。

OperationContext具有下列屬性和方法。

• 屬性會 Current 傳 OperationContext 回代表目前執行內容的物件。

• 屬性 ServiceSecurityContext 會傳回方法執行所在的安全性環境。

• 屬性 EndpointDispatcher 會取得作業的 System.ServiceModel.Dispatcher.EndpointDispatcher 。

• 屬性會 Extensions 傳回目前 OperationContext 的擴充集合。

• 屬性 Host 會傳 ServiceHostBase 回管理服務的物件。

• 屬性會 HasSupportingTokens 傳回值，指出方法是否具有支援的權杖，如果是的話，屬性就會 SupportingTokens 取得它們。

• IncomingMessageHeaders、 IncomingMessageProperties 和 IncomingMessageVersion 屬性會從傳入訊息取得這些專案。

• 作業 OperationCompleted 完成時會引發 事件。

• OutgoingMessageHeaders和 OutgoingMessageProperties 屬性會取得輸出訊息的這些專案。

• 屬性 RequestContext 會 RequestContext 傳回 方法的實作。

• 屬性會 InstanceContextInstanceContext 傳回與作業相關聯的 。

• 屬性 SessionId 會傳回目前通道和物件的會話識別碼。

• 方法 GetCallbackChannel 會在雙工通訊的情況下，將回呼通道傳回給呼叫端。

• 方法 SetTransactionComplete 會認可目前的交易。

建構函式

OperationContext(IContextChannel)

使用指定之用戶端應用程式中的 OperationContext來初始化 IContextChannel 類別的新執行個體。

屬性

Channel	取得與目前 OperationContext 物件相關聯的通道。
Current	取得或設定目前執行緒的執行內容。
Extensions	從目前訊息內容取得服務擴充部分的集合。
IncomingMessageHeaders	取得 OperationContext 的傳入訊息標頭。
IncomingMessageProperties	取得 OperationContext 中傳入訊息的訊息屬性。
IncomingMessageVersion	取得 OperationContext 的傳入 SOAP 訊息版本。
IsUserContext	本屬性僅供系統使用，使用者不應呼叫。
OutgoingMessageHeaders	取得使用中 OperationContext 的傳出訊息標頭。
OutgoingMessageProperties	取得使用中 OperationContext 內的傳出訊息之訊息屬性。
RequestContext	取得或設定本方法的 RequestContext 實作。

方法

GetCallbackChannel<T>()

取得至用戶端執行個體的通道，此通道呼叫了目前作業。

事件

OperationCompleted

發生於作業已經完成時。

適用於