OperationContext Classe

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Origine:

OperationContext.cs

Fornisce l'accesso al contesto di esecuzione di un metodo di servizio.

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)

Ereditarietà

Object

OperationContext

Implementazioni

IExtensibleObject<OperationContext>

Esempio

Nell'esempio di codice seguente viene utilizzata la proprietà e GetCallbackChannel il metodo per ottenere nuovamente il Current canale al chiamante dall'interno di un metodo. Tutti i metodi descritti in questo esempio sono metodi unidirezionali che consentono al servizio e al clienti di comunicare in modo indipendente in entrambe le direzioni. In questo caso, l'applicazione client di esempio prevede solo una chiamata restituita prima di uscire, ma un altro client, ad esempio un client Windows Forms, può ricevere qualsiasi numero di chiamate dal servizio.

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

Il client seguente implementa l'oggetto SampleDuplexHelloCallback per ricevere il messaggio di callback. Il contratto di callback importato non corrisponde a quello del servizio, a causa dell'uso della Name proprietà nell'esempio precedente. Si noti che il client non fa alcuna ipotesi sulla possibilità di ricevere un callback e sul momento in cui può riceverlo. Il callback del server è completamente indipendente dalla chiamata in uscita del client.

Nota

Per un esempio che usa la OperationContext classe in uno scenario client, vedere 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

Commenti

Usare l'oggetto OperationContext dall'interno di un'operazione di servizio per accedere all'ambiente di esecuzione dell'operazione corrente. In particolare, il contesto dell'operazione viene utilizzato per accedere ai canali callback nei servizi duplex, per archiviare dati aggiuntivi sullo stato in più parti delle operazioni, per accedere alle intestazioni e alle proprietà dei messaggi in ingresso e per aggiungere intestazioni e proprietà ai messaggi in uscita.

Per altre informazioni sull'uso delle estensioni per archiviare i dati sullo stato, vedere Estendibili oggetti.

Include OperationContext le proprietà e i metodi seguenti.

• La Current proprietà restituisce l'oggetto che rappresenta il OperationContext contesto di esecuzione corrente.

• La ServiceSecurityContext proprietà restituisce l'ambiente di sicurezza in cui viene eseguito il metodo.

• La EndpointDispatcher proprietà ottiene l'oggetto dell'operazione System.ServiceModel.Dispatcher.EndpointDispatcher.

• La Extensions proprietà restituisce un insieme di estensioni per l'oggetto corrente OperationContext.

• La Host proprietà restituisce l'oggetto ServiceHostBase che gestisce il servizio.

• La HasSupportingTokens proprietà restituisce un valore che indica se il metodo ha token di supporto, in caso affermativo, la SupportingTokens proprietà li ottiene.

• Le IncomingMessageHeadersproprietà , IncomingMessagePropertiese IncomingMessageVersion ottengono questi elementi dal messaggio in ingresso.

• L'evento OperationCompleted viene attivato al termine dell'operazione.

• Le OutgoingMessageHeaders proprietà e OutgoingMessageProperties ottengono questi elementi per il messaggio in uscita.

• La RequestContext proprietà restituisce l'implementazione RequestContext per il metodo .

• La InstanceContext proprietà restituisce l'oggetto InstanceContext associato all'operazione.

• La SessionId proprietà restituisce l'identificatore della sessione per il canale e l'oggetto corrente.

• Il GetCallbackChannel metodo restituisce un canale di callback al chiamante nel caso di comunicazione duplex.

• Il SetTransactionComplete metodo esegue il commit della transazione corrente.

Costruttori

OperationContext(IContextChannel)

Consente di inizializzare una nuova istanza della classe OperationContext che utilizza l'interfaccia IContextChannel specificata in un'applicazione client.

Proprietà

Channel	Consente di ottenere il canale associato all'oggetto OperationContext corrente.
ClaimsPrincipal	Ottiene il principale basato sulle attestazioni associato all'operazione.
Current	Consente di ottenere o impostare il contesto di esecuzione del thread corrente.
EndpointDispatcher	Consente di ottenere o impostare il dispatcher dell'endpoint da esaminare o modificare.
Extensions	Consente di ottenere la raccolta delle estensioni di servizio a partire dal contesto corrente dei messaggi.
IncomingMessageHeaders	Consente di ottenere le intestazioni dei messaggi in ingresso relative al contesto OperationContext.
IncomingMessageProperties	Consente di ottenere le proprietà dei messaggi in ingresso nel contesto OperationContext.
IncomingMessageVersion	Consente di ottenere la versione del messaggio SOAP in ingresso del contesto OperationContext.
InstanceContext	Consente di ottenere l'oggetto InstanceContext che gestisce l'istanza di servizio corrente.
IsUserContext	Questa proprietà è destinata all'utilizzo da parte del sistema e non deve essere chiamata dagli utenti.
OutgoingMessageHeaders	Consente di ottenere le intestazioni dei messaggi in uscita relative al contesto OperationContext attivo.
OutgoingMessageProperties	Consente di ottenere le proprietà dei messaggi in uscita nel contesto OperationContext attivo.
RequestContext	Consente di ottenere o impostare l'implementazione del contesto RequestContext di questo metodo.
SessionId	Consente di ottenere la stringa String utilizzata per identificare la sessione corrente.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetCallbackChannel<T>()	Consente di ottenere un canale per l'istanza client che ha chiamato l'operazione corrente.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

OperationCompleted

Si verifica al termine dell'operazione.