SessionMode Перечисление

Определение

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

System.ServiceModel

Сборки:

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

Пакет:

System.ServiceModel.Primitives v10.0.652802

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

SessionMode.cs

Указывает значения, доступные для указания поддержки надежных сеансов, необходимых или поддерживаемых контрактом.

public enum class SessionMode

public enum SessionMode

type SessionMode = 

Public Enum SessionMode

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

Object

ValueType

Enum

SessionMode

Поля

Имя	Значение	Описание
Allowed	0	Указывает, что контракт поддерживает сеансы, если входящая привязка поддерживает их.
Required	1	Указывает, что для контракта требуется сеансовая привязка. Исключение возникает, если привязка не настроена для поддержки сеанса.
NotAllowed	2	Указывает, что контракт никогда не поддерживает привязки, инициирующие сеансы.

Примеры

В следующем примере кода показано, как использовать SessionMode свойство ServiceContractAttribute для указания того, что IMyService контракт службы требует привязок, поддерживающих состояние сеанса.

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

  [ServiceBehaviorAttribute(InstanceContextMode=InstanceContextMode.PerSession)]
  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

  <ServiceBehaviorAttribute(InstanceContextMode:=InstanceContextMode.PerSession)> _
  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 As IHelloCallbackContract = 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

Комментарии

Используйте перечисление со свойством SessionModeServiceContractAttribute.SessionMode , чтобы требовать, разрешать или запрещать привязки использовать сеансы между конечными точками, которые подключаются к контракту службы или поддерживают его. Сеанс — это способ сопоставления набора сообщений, обменуемых между двумя или несколькими конечными точками. Дополнительные сведения о сеансах см. в разделе "Использование сеансов".

Если служба поддерживает сеансы, можно использовать ServiceBehaviorAttribute.InstanceContextMode свойство, чтобы указать связь между экземплярами реализации контракта службы и сеансом канала.

Например, если ServiceContractAttribute.SessionMode для свойства задано значение и ServiceBehaviorAttribute.InstanceContextMode для свойства Allowed задано InstanceContextMode.PerSessionзначение, клиент может использовать привязку, которая поддерживает надежные сеансы для выполнения повторяющихся вызовов к одному объекту службы.

Поскольку сеанс — это концепция уровня канала, которую использует модель приложения, существует взаимодействие между SessionMode перечислением в контракте и ServiceBehaviorAttribute.InstanceContextMode свойством, которое управляет связью между каналами и конкретными объектами службы.

В следующей таблице показан результат входящего канала либо поддержки надежных сеансов, либо не поддерживает надежные сеансы, учитывая сочетание значений ServiceContractAttribute.SessionMode свойства и ServiceBehaviorAttribute.InstanceContextMode свойства.

Значение InstanceContextMode	Обязательный	Допустимо	Не разрешено
PerCall	— Поведение с каналом, поддерживающим сеанс: сеанс и System.ServiceModel.InstanceContext для каждого вызова. — Поведение с каналом без сеансов: выбрасывается исключение.	— Поведение с каналом, поддерживающим сеанс: сеанс и System.ServiceModel.InstanceContext для каждого вызова. — Поведение с каналом без сеансов: System.ServiceModel.InstanceContext для каждого вызова.	— Поведение с сеансовым каналом: создается исключение. — Поведение с каналом без сеансов: System.ServiceModel.InstanceContext для каждого вызова.
PerSession	— Поведение с сеансным каналом: сеанс и System.ServiceModel.InstanceContext для каждого канала. — Поведение с каналом без сеансов: выбрасывается исключение.	— Поведение с сеансным каналом: сеанс и System.ServiceModel.InstanceContext для каждого канала. — Поведение с каналом без сеансов: System.ServiceModel.InstanceContext для каждого вызова.	— Поведение с сеансовым каналом: создается исключение. — Поведение с каналом без сеансов: System.ServiceModel.InstanceContext для каждого вызова.
Single	— Поведение с сеансовым каналом: один сеанс и один System.ServiceModel.InstanceContext для всех вызовов. — Поведение с каналом без сеансов: выбрасывается исключение.	— Поведение с сеансовым каналом: сеанс и System.ServiceModel.InstanceContext для каждого созданного одноэлемента или для указанного пользователем одноэлемента. — Поведение с бессессионным каналом: System.ServiceModel.InstanceContext для каждого созданного синглтона или для указанного пользователем синглтона.	— Поведение с сеансовым каналом: создается исключение. — Поведение с бессессионным каналом: System.ServiceModel.InstanceContext для каждого созданного синглтона или для указанного пользователем синглтона.