CustomBinding クラス

定義

public ref class CustomBinding : System::ServiceModel::Channels::Binding

public class CustomBinding : System.ServiceModel.Channels.Binding

[System.Windows.Markup.ContentProperty("Elements")]
public class CustomBinding : System.ServiceModel.Channels.Binding

type CustomBinding = class
    inherit Binding

[<System.Windows.Markup.ContentProperty("Elements")>]
type CustomBinding = class
    inherit Binding

Public Class CustomBinding
Inherits Binding

継承

Object

Binding

CustomBinding

属性

ContentPropertyAttribute

例

次の例では、CustomBinding および ReliableSessionBindingElement を使用して HttpTransportBindingElement オブジェクトを作成する方法を示します。

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

注釈

システムが提供するバインディングの中にサービスの要件を満たすものがない場合は、カスタム バインドを使用します。 たとえば、カスタム バインドを使用すると、サービス エンドポイントで新しいトランスポートや新しいエンコーダーを使用できます。

カスタム バインドは、特定の順序で "積み重ねられている" バインド要素のコレクションから CustomBinding の 1 つを使用して作成します。

• 最上位にあるのは、トランザクションのフローを可能にするオプションの TransactionFlowBindingElement です。

• その次にあるのは、WS-ReliableMessaging 仕様で定義されているセッションおよび順序指定のメカニズムを提供するオプションの ReliableSessionBindingElement です。 このセッションの概念は、SOAP およびトランスポート中継局を通過できます。

• その次にあるのは、承認、認証、保護、機密性などのセキュリティ機能を提供するオプションのセキュリティ バインド要素です。 次のセキュリティ バインディング要素が Windows Communication Foundation (WCF) から提供されます。

  • SecurityBindingElement

  • AsymmetricSecurityBindingElement

  • SymmetricSecurityBindingElement

  • TransportSecurityBindingElement

• その次にあるのは、バインド要素によって指定されるオプションのメッセージ パターンです。

• CompositeDuplexBindingElement

• その次にあるのは、オプションのトランスポート アップグレード/ヘルパー バインド要素です。

  • PnrpPeerResolverBindingElement

  • SslStreamSecurityBindingElement

  • WindowsStreamSecurityBindingElement

• その次にあるのは、必須のメッセージ エンコード バインド要素です。 独自のトランスポートを使用することも、以下のメッセージ エンコード バインドのいずれかを使用することもできます。

  • TextMessageEncodingBindingElement

  • BinaryMessageEncodingBindingElement

  • MtomMessageEncodingBindingElement

• 最下位には、必須のトランスポート要素があります。 独自のトランスポートを使用するか、Windows Communication Foundation (WCF) から提供されるトランスポート バインディング要素の 1 つを使用できます。

  • TcpTransportBindingElement

  • NamedPipeTransportBindingElement

  • HttpTransportBindingElement

  • HttpsTransportBindingElement

  • MsmqTransportBindingElement

  • MsmqIntegrationBindingElement

  • PeerTransportBindingElement

各層のオプションの概要を次の表に示します。

さらに、独自のバインド要素を定義し、それを定義済みの層のいずれかの間に挿入できます。

カスタム バインディングを使用し、システム提供のバインディングを変更する方法については、「方法: システム指定のバインディングをカスタマイズする」を参照してください。

コンストラクター

プロパティ

メソッド

適用対象