OperationContextScope Osztály

Definíció

Névtér:

System.ServiceModel

Szerelvények:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Csomag:

System.ServiceModel.Primitives v10.0.652802

Forrás:

OperationContextScope.cs

Létrehoz egy blokkot, amelyben egy OperationContext objektum hatókörben van.

public ref class OperationContextScope sealed : IDisposable

public sealed class OperationContextScope : IDisposable

type OperationContextScope = class
    interface IDisposable

Public NotInheritable Class OperationContextScope
Implements IDisposable

Öröklődés

Object

OperationContextScope

Megvalósítás

IDisposable

Példák

Az alábbi példa bemutatja, hogyan hozhat OperationContextScope létre új környezetet egy ügyfélalkalmazásban egy egyéni fejléc hozzáadásához a kimenő üzenethez.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Threading;

public class Client : ISampleServiceCallback
{
  ManualResetEvent wait = null;

  Client()
  {
    this.wait = new ManualResetEvent(false);
  }

  public static void Main()
  {
    Client client = new Client();
    client.Run();
  }

  void Run()
  {
    // Picks up configuration from the config file.
    SampleServiceClient wcfClient = new SampleServiceClient(new InstanceContext(this));
    try
    {
      using (OperationContextScope scope = new OperationContextScope(wcfClient.InnerChannel))
      {
        MessageHeader header
          = MessageHeader.CreateHeader(
          "Service-Bound-CustomHeader",
          "http://Microsoft.WCF.Documentation",
          "Custom Happy Value."
          );
        OperationContext.Current.OutgoingMessageHeaders.Add(header);

        // Making calls.
        Console.WriteLine("Enter the greeting to send: ");
        string greeting = Console.ReadLine();

        //Console.ReadLine();
        header = MessageHeader.CreateHeader(
            "Service-Bound-OneWayHeader",
            "http://Microsoft.WCF.Documentation",
            "Different Happy Value."
          );
        OperationContext.Current.OutgoingMessageHeaders.Add(header);

        // One-way
        wcfClient.Push(greeting);
        this.wait.WaitOne();

        // Done with service.
        wcfClient.Close();
        Console.WriteLine("Done!");
        Console.ReadLine();
      }
    }
    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();
    }
  }


  #region ISampleServiceCallback Members

  public void PushBack(string msg)
  {
    Console.WriteLine("Service said: " + msg);
    this.WriteHeaders(OperationContext.Current.IncomingMessageHeaders);
    this.wait.Set();
  }

  void WriteHeaders(MessageHeaders headers)
  {
    Console.ForegroundColor = ConsoleColor.Red;
    Console.WriteLine("IncomingHeader:");
    Console.ForegroundColor = ConsoleColor.Blue;
    foreach (MessageHeaderInfo h in headers)
    {
      if (!h.Actor.Equals(String.Empty))
        Console.WriteLine("\t" + h.Actor);
      Console.ForegroundColor = ConsoleColor.White;
      Console.WriteLine("\t" + h.Name);
      Console.ForegroundColor = ConsoleColor.Blue;
      Console.WriteLine("\t" + h.Namespace);
      Console.WriteLine("\t" + h.Relay);
      if (h.IsReferenceParameter)
      {
        Console.WriteLine("IsReferenceParameter header detected: " + h.ToString());
      }
    }
    Console.ResetColor();
  }
  #endregion
}

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

Public Class Client
    Implements ISampleServiceCallback
  Private wait As ManualResetEvent = Nothing

  Private Sub New()
    Me.wait = New ManualResetEvent(False)
  End Sub

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

  Private Sub Run()
    ' Picks up configuration from the config file.
    Dim wcfClient As New SampleServiceClient(New InstanceContext(Me))
    Try
      Using scope As New OperationContextScope(wcfClient.InnerChannel)
                Dim header As MessageHeader = MessageHeader.CreateHeader("Service-Bound-CustomHeader", _
                                    "http://Microsoft.WCF.Documentation", "Custom Happy Value.")
        OperationContext.Current.OutgoingMessageHeaders.Add(header)

        ' Making calls.
        Console.WriteLine("Enter the greeting to send: ")
        Dim greeting As String = Console.ReadLine()

        'Console.ReadLine();
                header = MessageHeader.CreateHeader("Service-Bound-OneWayHeader", _
                                                    "http://Microsoft.WCF.Documentation", "Different Happy Value.")
        OperationContext.Current.OutgoingMessageHeaders.Add(header)

        ' One-way
        wcfClient.Push(greeting)
        Me.wait.WaitOne()

        ' Done with service. 
        wcfClient.Close()
        Console.WriteLine("Done!")
        Console.ReadLine()
      End Using
    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


  #Region "ISampleServiceCallback Members"

  Public Sub PushBack(ByVal msg As String) Implements ISampleServiceCallback.PushBack
    Console.WriteLine("Service said: " & msg)
    Me.WriteHeaders(OperationContext.Current.IncomingMessageHeaders)
    Me.wait.Set()
  End Sub

  Private Sub WriteHeaders(ByVal headers As MessageHeaders)
    Console.ForegroundColor = ConsoleColor.Red
    Console.WriteLine("IncomingHeader:")
    Console.ForegroundColor = ConsoleColor.Blue
    For Each h As MessageHeaderInfo In headers
      If Not h.Actor.Equals(String.Empty) Then
        Console.WriteLine(vbTab & h.Actor)
      End If
      Console.ForegroundColor = ConsoleColor.White
      Console.WriteLine(vbTab & h.Name)
      Console.ForegroundColor = ConsoleColor.Blue
      Console.WriteLine(vbTab & h.Namespace)
      Console.WriteLine(vbTab & h.Relay)
      If h.IsReferenceParameter = True Then
        Console.WriteLine("IsReferenceParameter header detected: " & h.ToString())
      End If
    Next h
    Console.ResetColor()
  End Sub
  #End Region

End Class

Megjegyzések

OperationContextScope Az osztály használatával létrehozhat egy hatókört egy adott OperationContext objektumhoz vagy egy új OperationContext objektum hatóköréhez egy megadott IContextChannel objektum használatával. Egy OperationContextScope használható Windows kommunikációs alaprendszer (WCF) szolgáltatásban vagy WCF-ügyfélalkalmazásban.

Miután az OperationContextScope objektum létrehozta az aktuális műveleti környezetet, a következő műveleteket használhatja OperationContext :

• Bejövő és kimenő üzenetfejlécek és egyéb tulajdonságok elérése és módosítása.

• Hozzáférés a futtatókörnyezethez, beleértve a diszpécsereket, a gazdagépet, a csatornát és a bővítményeket.

• Hozzáférés más típusú környezetekhez, például biztonsági, példány- és kéréskörnyezetekhez.

• Hozzáférés az objektumhoz társított csatornához OperationContext , vagy (ha a csatorna implementálja System.ServiceModel.Channels.ISession) a társított csatorna munkamenet-azonosítóját.

Amikor létrejön egy OperationContextScope eszköz, a rendszer tárolja az aktuálisat OperationContext , és az új OperationContext lesz a Current tulajdonság által visszaadott. OperationContextScope A megsemmisítéskor az eredeti OperationContext visszaáll.

Warning

Ne használja az aszinkron "await" mintát az OperationContextScope blokkon belül. Ha a folytatás történik, az egy másik szálon futhat, és az OperationContextScope szálspecifikus. Ha egy aszinkron híváshoz "await" (várakozás) hívásra van szüksége, használja azt az OperationContextScope blokkon kívül.

Konstruktorok

Name	Description
OperationContextScope(IContextChannel)	Inicializálja az OperationContextScope osztály új példányát, amely a megadott IContextChannel használatával hoz létre újat OperationContext a hatókörhöz.
OperationContextScope(OperationContext)	Inicializálja az osztály új példányát a OperationContextScope megadott OperationContext objektum hatókörének létrehozásához.

Metódusok

Name	Description
Dispose()	Visszaállítja az eredetit OperationContext az aktív környezetbe, és újrahasznosítja az OperationContextScope objektumot.