Language

ServiceContractAttribute.SessionMode プロパティ

定義

セッションが許可されるか、許可されないか、または必要であるかを示す値を取得または設定します。

public:
 property System::ServiceModel::SessionMode SessionMode { System::ServiceModel::SessionMode get(); void set(System::ServiceModel::SessionMode value); };
public System.ServiceModel.SessionMode SessionMode { get; set; }
member this.SessionMode : System.ServiceModel.SessionMode with get, set
Public Property SessionMode As SessionMode

プロパティ値

セッションが許可されているか、許可されていないか、または必須であるかを示す SessionMode 。

例外

値は、 SessionMode 値の 1 つではありません。

例

次のサービス コントラクトでは、構成されたバインディングが、 SampleDuplexHello サービス実装と対話するときにセッションを使用する必要があります。

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

注釈

エンドポイント間のセッションをサポートするバインディングを要求するには、 SessionMode プロパティを使用します。 セッションは、2 つ以上のエンドポイント間で交換される一連のメッセージを関連付ける方法です。 サービスがチャネル セッションをサポートしている場合は、 InstanceContextMode プロパティを使用して、サービス コントラクトの実装とチャネル セッションのインスタンス間の関係を指定できます。 バインディングがセッションをサポートしていない場合は、例外がスローされます。

たとえば、 SessionMode プロパティが SessionMode.Required に設定されていて、 InstanceContextMode プロパティが PerSession に設定されている場合、クライアントは同じ接続を使用して同じサービス オブジェクトを繰り返し呼び出すことができます。

セッションとサービス インスタンスの詳細については、「セッションとセッションの使用、インスタンス化、コンカレンシー」を参照してください。

Note

セッションをサポートするチャネルは、サービス インスタンスと特定のセッションの既定の関連付けをサポートします。 ただし、セッションの実装によって、セッション ベースのインスタンス化制御に加えて、さまざまな機能がサポートされます。 WCF には、セッションフル アプリケーションの動作を提供するために使用できる 4 種類のセッションが用意されています。セッションの種類ごとに、セッションの種類に固有の追加の動作が提供されます。

  1. System.ServiceModel.Channels.SecurityBindingElementでは、通信の両端が暗号化やデジタル署名プロセスに同意したセキュリティ セッションがサポートされます。すべてのメッセージは、その特定のセキュリティで保護された会話と関連付けられます。 詳細については、「サービスの セキュリティ保護」を参照してください。 たとえば、セキュリティ セッションと信頼できるセッションの両方のサポートを含む System.ServiceModel.WSHttpBindingでは、既定では、メッセージを暗号化してデジタル署名するセキュリティで保護されたセッションのみが使用されます。

  2. System.ServiceModel.NetTcpBindingでは、TCP/IP 接続によって公開されるセッションがサポートされ、すべてのメッセージがソケット レベルの接続セッションによって確実に関連付けられます。

  3. WS-ReliableMessaging 仕様を実装する System.ServiceModel.Channels.ReliableSessionBindingElementでは、メッセージが順番に 1 回だけ配信される信頼性の高いセッションがサポートされ、メッセージが会話中に複数のノード間を移動した場合でも信頼できます。 詳細については、「 信頼できるセッション」を参照してください。

  4. System.ServiceModel.NetMsmqBindingは、MSMQ データグラム セッションを提供します。 詳細については、「 WCF のキュー」を参照してください。

SessionMode プロパティを設定しても、コントラクトに必要なセッションの種類は指定されず、必要なのは 1 つだけであることに注意してください。

適用対象