ReliableSessionBindingElement クラス

定義

エンドポイント間の信頼できるセッションに必要な送信および受信チャネルを作成できるバインド要素を表します。Represents the binding element that can produce the sending and receiving channels required for a reliable session between endpoints.

public ref class ReliableSessionBindingElement sealed : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Description::IPolicyExportExtension
public sealed class ReliableSessionBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Description.IPolicyExportExtension
type ReliableSessionBindingElement = class
    inherit BindingElement
    interface IPolicyExportExtension
Public NotInheritable Class ReliableSessionBindingElement
Inherits BindingElement
Implements IPolicyExportExtension
継承
ReliableSessionBindingElement
実装

ReliableSessionBindingElement は、任意のカスタム バインドに追加できます。The ReliableSessionBindingElement can be added to any custom binding. カスタム バインドへの追加は、次の構成要素を使用して行います。This is done using the following configuration elements.

<bindings>  
    <customBinding>  
        <binding configurationName="ReliabilityHTTP">  
            <reliableSession/>  
        </binding>  
    </customBinding>  
</bindings>  

コード内で ReliableSessionBindingElement を使用する方法を次のコード例に示します。The following sample code demonstrates how to use ReliableSessionBindingElement in code.

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);
  
    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}
Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    ' Create a custom binding that contains two binding elements.
    Dim reliableSession As New ReliableSessionBindingElement()
    reliableSession.Ordered = True

    Dim httpTransport As New HttpTransportBindingElement()
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

    Dim binding As New CustomBinding(reliableSession, httpTransport)

    ' Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

    ' Add a MEX endpoint.
    Dim smb As New ServiceMetadataBehavior()
    smb.HttpGetEnabled = True
    smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
    serviceHost.Description.Behaviors.Add(smb)

    ' Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open()

    ' The service can now be accessed.
    Console.WriteLine("The service is ready.")
    Console.WriteLine("Press <ENTER> to terminate service.")
    Console.WriteLine()
    Console.ReadLine()

    ' Close the ServiceHostBase to shutdown the service.
    serviceHost.Close()
End Using

注釈

セッションを提供し、オプションとして順序付けされたメッセージ配信を提供します。Provides sessions and optionally provides ordered message delivery. この実装されたセッションは、SOAP およびトランスポート中継局を通過できます。This implemented session can cross SOAP and transport intermediaries.

各バインド要素は、メッセージの送信または受信時の処理手順を表します。Each binding element represents a processing step when sending or receiving messages. 実行時に、バインド要素は、メッセージの送受信に求められる送信および受信チャネル スタックを作成するために必要なチャネル ファクトリとリスナーを作成します。At runtime, binding elements create the channel factories and listeners that are necessary to build outgoing and incoming channel stacks required to send and receive messages. ReliableSessionBindingElement が提供するスタック内のオプションの層は、エンドポイント間に信頼できるセッションを確立し、このセッションの動作を構成することができます。The ReliableSessionBindingElement provides an optional layer in the stack that can establish a reliable session between endpoints and configure the behavior of this session.

ReliableSessionBindingElement は、次の表の標準バインドで提供されます。The ReliableSessionBindingElement is provided on the standard bindings in the following table.

バインドBinding 既定値Default
NetTcpBinding オフOff
WSHttpBinding オフOff
WSDualHttpBinding オン (必須)On (required)

コンストラクター

ReliableSessionBindingElement()

ReliableSessionBindingElement クラスの新しいインスタンスを初期化します。Initializes a new instance of the ReliableSessionBindingElement class.

ReliableSessionBindingElement(Boolean)

メッセージが送信された順序をメッセージ配信で維持する必要があるかどうかを指定する ReliableSessionBindingElement クラスの新しいインスタンスを初期化します。Initializes a new instance of the ReliableSessionBindingElement class that specifies whether message delivery must preserve the order in which messages are sent.

プロパティ

AcknowledgementInterval

ファクトリによって作成された信頼できるチャネルで、メッセージの送信元に受信確認を送信するまで送信先が待機する時間を取得または設定します。Gets or sets the interval of time that a destination waits before sending an acknowledgment to the message source on reliable channels that are created by the factory.

FlowControlEnabled

信頼できるセッションでフロー制御が有効かどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the reliable session has flow control enabled.

InactivityTimeout

サービスが非アクティブになってから終了するまでの時間を取得または設定します。Gets or sets an interval of time that a service remains inactive before closing.

MaxPendingChannels

信頼できるセッションの間に保留できるチャネルの最大数を取得または設定します。Gets or sets the largest number of channels that can be pending during the reliable session.

MaxRetryCount

信頼できるセッションの間にメッセージの転送を試行する最大回数を取得または設定します。Gets or sets the maximum number of times that a message attempts to be transferred during the reliable session.

MaxTransferWindowSize

送信バッファーまたは受信バッファーに存在できるメッセージの最大数を取得または設定します。Gets or sets the largest number of messages that can exist in either the send buffer or the receive buffer.

Ordered

メッセージが送信された順序をメッセージ配信で維持する必要があるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether message delivery must preserve the order in which messages are sent.

ReliableMessagingVersion

バインド要素で指定された WS-ReliableMessaging のバージョンを取得または設定します。Gets or sets the version of WS-ReliableMessaging specified by the binding element.

メソッド

BuildChannelFactory<TChannel>(BindingContext)

信頼できるセッションをサポートする、指定した種類のチャネルを作成するファクトリを返します。Returns a factory that creates a channel of a specified type that supports a reliable session.

BuildChannelListener<TChannel>(BindingContext)

信頼できるセッションをサポートする、指定した種類のチャネルを受け入れるリスナーを返します。Returns a listener that accepts a channel of a specified type that supports a reliable session.

CanBuildChannelFactory<TChannel>(BindingContext)

指定したチャネルとコンテキストに対して信頼できるセッションをサポートするチャネル ファクトリを作成できるかどうかを示す値を返します。Returns a value that indicates whether the channel factory can be built for the channel and context provided that can support a reliable session.

CanBuildChannelListener<TChannel>(BindingContext)

指定したチャネルとコンテキストに対して信頼できるセッションをサポートするチャネル リスナーを作成できるかどうかを示す値を返します。Returns a value that indicates whether the channel listener can be built for the channel and context provided that can support a reliable session.

Clone()

現在の信頼できるセッションのバインド要素のコピーを作成します。Creates a copy of the current reliable session binding element.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetProperty<T>(BindingContext)

バインド コンテキストから、指定した型のプロパティを取得します。Gets a property of the specified type from its binding context.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

明示的なインターフェイスの実装

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

信頼できるセッションのバインド要素に含まれる情報を WSDL 要素にマップします。この要素は、リモート エンドポイントが信頼できるセッションでサービスにアクセスできるようにするものです。Maps the information contained in the reliable session binding element into the WSDL elements that enable a remote endpoint to access the service with a reliable session.

適用対象