OperationContext Класс

Определение

Пространство имен:

System.ServiceModel

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v6.2.0

Исходный код:

OperationContext.cs

Предоставляет доступ к контексту выполнения метода службы.

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)

Наследование

Object

OperationContext

Реализации

IExtensibleObject<OperationContext>

Примеры

В следующем примере кода используются Current свойство и GetCallbackChannel метод для получения канала обратно вызывающей стороне из метода . Все методы в этом примере являются односторонними, позволяя службе и клиенту независимо взаимодействовать в обоих направлениях. В этом случае пример клиентского приложения ожидает только один обратный вызов перед выходом, но другой клиент, например клиент Windows Forms, может принимать любое количество вызовов от службы.

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

Imports System.Collections.Generic
Imports System.ServiceModel
Imports System.Threading

Namespace Microsoft.WCF.Documentation
    <ServiceContract(Name:="SampleDuplexHello", Namespace:="http://microsoft.wcf.documentation", _
                     CallbackContract:=GetType(IHelloCallbackContract), SessionMode:=SessionMode.Required)> _
  Public Interface IDuplexHello
        <OperationContract(IsOneWay:=True)> _
        Sub Hello(ByVal greeting As String)
    End Interface

  Public Interface IHelloCallbackContract
    <OperationContract(IsOneWay := True)> _
    Sub Reply(ByVal responseToGreeting As String)
  End Interface

  Public Class DuplexHello
      Implements IDuplexHello
    Public Sub New()
      Console.WriteLine("Service object created: " & Me.GetHashCode().ToString())
    End Sub

    Protected Overrides Sub Finalize()
      Console.WriteLine("Service object destroyed: " & Me.GetHashCode().ToString())
    End Sub

    Public Sub Hello(ByVal greeting As String) Implements IDuplexHello.Hello
      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)
            Dim callerProxy = OperationContext.Current.GetCallbackChannel(Of IHelloCallbackContract)()
            Dim response = "Service object " & Me.GetHashCode().ToString() & " received: " & greeting
      Console.WriteLine("Sending back: " & response)
      callerProxy.Reply(response)
    End Sub
  End Class
End Namespace

Следующий клиент реализует SampleDuplexHelloCallback для получения сообщения обратного вызова. Импортированный контракт обратного вызова не совпадает с именем в службе из-за использования Name свойства в предыдущем примере. Необходимо отметить, что клиент не делает предположения относительно возможности получения обратного вызова. Обратный вызов сервера полностью независим от исходящего вызова клиента.

Примечание

Пример использования класса в клиентском OperationContext сценарии см. в разделе OperationContextScope.

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

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Threading

Namespace Microsoft.WCF.Documentation
  Public Class Client
      Implements SampleDuplexHelloCallback
    Private waitHandle As AutoResetEvent

    Public Sub New()
      waitHandle = New AutoResetEvent(False)
    End Sub

    Public Sub Run()
      ' Picks up configuration from the config file.
      Dim wcfClient As New SampleDuplexHelloClient(New InstanceContext(Me))
      Try
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Enter a greeting to send and press ENTER: ")
        Console.Write(">>> ")
        Console.ForegroundColor = ConsoleColor.Green
                Dim greeting = Console.ReadLine()
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Called service with: " & Constants.vbCrLf & Constants.vbTab & greeting)
        wcfClient.Hello(greeting)
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.")
        Me.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 timeProblem As TimeoutException
        Console.WriteLine("The service operation timed out. " & timeProblem.Message)
        Console.ReadLine()
        wcfClient.Abort()
      Catch commProblem As CommunicationException
        Console.WriteLine("There was a communication problem. " & commProblem.Message)
        Console.ReadLine()
        wcfClient.Abort()
      End Try
    End Sub

    Public Shared Sub Main()
      Dim client As New Client()
      client.Run()
    End Sub

    Public Sub Reply(ByVal response As String) Implements SampleDuplexHelloCallback.Reply
      Console.WriteLine("Received output.")
      Console.WriteLine(Constants.vbCrLf & Constants.vbTab & response)
      Me.waitHandle.Set()
    End Sub
  End Class
End Namespace

Комментарии

OperationContext Используйте из в операции службы для доступа к текущей среде выполнения операций. Контекст операции используется для доступа к каналам обратного вызова в дуплексных службах, для хранения дополнительных данных о состоянии для разных частей операций, для доступа к заголовкам и свойствам входящих сообщений и для добавления заголовков и свойств в исходящие сообщения.

Дополнительные сведения об использовании расширений для хранения данных о состоянии см. в разделе Расширяемые объекты.

Имеет OperationContext следующие свойства и методы.

• Свойство Current возвращает объект , OperationContext представляющий текущий контекст выполнения.

• Свойство ServiceSecurityContext возвращает среду безопасности, в которой выполняется метод .

• Свойство EndpointDispatcher получает значение операции System.ServiceModel.Dispatcher.EndpointDispatcher.

• Свойство Extensions возвращает коллекцию расширений для текущего OperationContextобъекта .

• Свойство Host возвращает ServiceHostBase объект , который управляет службой.

• Свойство HasSupportingTokens возвращает значение, указывающее, имеет ли метод вспомогательные маркеры. Если да, SupportingTokens свойство получает их.

• Свойства IncomingMessageHeaders, IncomingMessagePropertiesи IncomingMessageVersion получают эти элементы из входящего сообщения.

• Событие OperationCompleted запускается после завершения операции.

• Свойства OutgoingMessageHeaders и OutgoingMessageProperties получают эти элементы для исходящего сообщения.

• Свойство RequestContext возвращает реализацию RequestContext метода .

• Свойство InstanceContext возвращает объект , связанный InstanceContext с операцией.

• Свойство SessionId возвращает идентификатор сеанса для текущего канала и объекта .

• Метод GetCallbackChannel возвращает канал обратного вызова вызывающей объекту в случае дуплексного взаимодействия.

• Метод SetTransactionComplete фиксирует текущую транзакцию.

Конструкторы

OperationContext(IContextChannel)

Инициализирует новый экземпляр класса OperationContext, использующий указанный канал IContextChannel в клиентском приложении.

Свойства

Channel	Получает канал, связанный с текущим объектом OperationContext.
ClaimsPrincipal	Получает субъект требований, связанный с операцией.
Current	Возвращает или задает контекст выполнения текущего потока.
EndpointDispatcher	Возвращает или задает диспетчер конечной точки для проверяемой или изменяемой конечной точки.
Extensions	Возвращает коллекцию расширений службы из контекста текущего сообщения.
IncomingMessageHeaders	Получает заголовки входящих сообщений для OperationContext.
IncomingMessageProperties	Получает свойства для входящего сообщения в контексте OperationContext.
IncomingMessageVersion	Получает свойства для SOAP-версии входящего сообщения в контексте OperationContext.
InstanceContext	Получает объект InstanceContext, управляющих текущим экземпляром службы.
IsUserContext	Это свойство предназначено для системных целей и не должно вызываться пользователями.
OutgoingMessageHeaders	Получает заголовки исходящих сообщений для активного контекста OperationContext.
OutgoingMessageProperties	Получает свойства для исходящего сообщения в активном контексте OperationContext.
RequestContext	Возвращает или задает реализацию RequestContext для этого метода.
SessionId	Получает строку String, используемую для идентификации текущего сеанса.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetCallbackChannel<T>()	Возвращает канал экземпляру клиента, вызвавшему текущую операцию.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

OperationCompleted

Создается по завершении операции.