方法 : システム指定のバインディングをカスタマイズする

[アーティクル]
02/24/2011

Windows Communication Foundation (WCF) には、システム指定のバインディングがいくつか含まれています。これらのバインディングを使用して、基になるバインド要素の一部のプロパティを構成できますが、すべてのプロパティを構成できるとは限りません。ここでは、バインド要素のプロパティを設定してカスタムバインディングを作成する方法を示します。

システム指定のバインディングを使用せずに、バインド要素を直接作成し構成する方法詳細情報、「カスタムバインディング」を参照してください。

カスタムバインディングの作成および拡張詳細情報、「バインディングの拡張」を参照してください。

WCF では、すべてのバインディングが複数の "バインド要素" で構成されています。各バインド要素は BindingElement クラスから派生します。BasicHttpBinding などのシステム指定のバインディングでは、独自のバインド要素が作成され構成されます。ここでは、バインディングに直接公開されないこのバインド要素 (具体的には BasicHttpBinding クラス) のプロパティにアクセスして変更する方法を示します。

個別のバインド要素は BindingElementCollection クラスで表されるコレクションに格納し、トランザクションフロー、信頼できるセッション、セキュリティ、複合二重、一方向、ストリームセキュリティ、メッセージエンコーディング、トランスポートの順に追加します。どのバインディングでも、これらすべてのバインド要素が必要になるとは限りません。ユーザー定義のバインド要素も、このバインド要素のコレクションに表示されますが、前述の順序で表示される必要があります。たとえば、ユーザー定義のトランスポートは、バインド要素コレクションの最後の要素となる必要があります。

BasicHttpBinding クラスには、次の 3 つのバインド要素が含まれています。

オプションのセキュリティバインド要素。HTTP トランスポートで使用される AsymmetricSecurityBindingElement クラス (メッセージレベルセキュリティ)、またはトランスポート層がセキュリティを提供する場合 (HTTPS トランスポート) に使用される TransportSecurityBindingElement。
必須のメッセージエンコーダーバインド要素。TextMessageEncodingBindingElement または MtomMessageEncodingBindingElement。
必須のトランスポートバインド要素。HttpTransportBindingElement または HttpsTransportBindingElement。

この例では、バインディングのインスタンスを作成し、そのインスタンスから "カスタムバインディング" を生成します。次にカスタムバインディング内のバインド要素を調べて HTTP バインド要素が見つかった場合は、その KeepAliveEnabled プロパティを false に設定します。KeepAliveEnabled プロパティは、BasicHttpBinding に直接公開されていないので、カスタムバインディングを作成し、バインド要素まで移動して、このプロパティを設定する必要があります。

システム標準のバインディングを変更するには

BasicHttpBinding クラスのインスタンスを作成し、そのセキュリティモードをメッセージレベルに設定します。

'  Create an instance of the T:System.ServiceModel.BasicHttpBinding 
'  class and set its security mode to message-level security.
Dim binding As New BasicHttpBinding()
With binding.Security
    .Message.ClientCredentialType = BasicHttpMessageCredentialType.Certificate
    .Mode = BasicHttpSecurityMode.Message
End With

バインディングからカスタムバインディングを作成し、そのカスタムバインディングのプロパティの 1 つから BindingElementCollection クラスを作成します。
```
'  Create a custom binding from the binding 
Dim cb As New CustomBinding(binding)
'  Get the BindingElementCollection from this custom binding 
Dim bec = cb.Elements
```

BindingElementCollection クラスをループして HttpTransportBindingElement クラスが見つかったら、その KeepAliveEnabled プロパティを false に設定します。

'  Loop through the collection, and when you find the HTTP binding element
'  set its KeepAliveEnabled property to false
For Each be In bec
    Dim thisType = be.GetType()
    Console.WriteLine(thisType)
    If TypeOf be Is HttpTransportBindingElement Then
        Dim httpElement As HttpTransportBindingElement = CType(be, HttpTransportBindingElement)
        Console.WriteLine(Constants.vbTab & "Before: HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
        httpElement.KeepAliveEnabled = False
        Console.WriteLine(vbTab & "After:  HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
    End If
Next be

次の方法で共有

方法 : システム指定のバインディングをカスタマイズする

システム標準のバインディングを変更するには

参照

リファレンス

概念

その他のリソース