IServiceBehavior.AddBindingParameters メソッド

定義

コントラクトの実装をサポートするカスタム データをバインド要素に渡せるようにします。

public:
 void AddBindingParameters(System::ServiceModel::Description::ServiceDescription ^ serviceDescription, System::ServiceModel::ServiceHostBase ^ serviceHostBase, System::Collections::ObjectModel::Collection<System::ServiceModel::Description::ServiceEndpoint ^> ^ endpoints, System::ServiceModel::Channels::BindingParameterCollection ^ bindingParameters);
public void AddBindingParameters (System.ServiceModel.Description.ServiceDescription serviceDescription, System.ServiceModel.ServiceHostBase serviceHostBase, System.Collections.ObjectModel.Collection<System.ServiceModel.Description.ServiceEndpoint> endpoints, System.ServiceModel.Channels.BindingParameterCollection bindingParameters);
abstract member AddBindingParameters : System.ServiceModel.Description.ServiceDescription * System.ServiceModel.ServiceHostBase * System.Collections.ObjectModel.Collection<System.ServiceModel.Description.ServiceEndpoint> * System.ServiceModel.Channels.BindingParameterCollection -> unit
Public Sub AddBindingParameters (serviceDescription As ServiceDescription, serviceHostBase As ServiceHostBase, endpoints As Collection(Of ServiceEndpoint), bindingParameters As BindingParameterCollection)

パラメーター

serviceDescription
ServiceDescription

サービスの説明。

serviceHostBase
ServiceHostBase

サービスのホスト。

endpoints
Collection<ServiceEndpoint>

サービス エンドポイント。

bindingParameters
BindingParameterCollection

バインド要素がアクセスできるカスタム オブジェクト。

注釈

AddBindingParameters メソッドを使用して、parameters コレクションにカスタム データ オブジェクトを追加します。バインディング要素は、このオブジェクトを使用して、コントラクトをサポートするための追加情報を取得します。

このメソッドは、リッスン URI ごとに 1 回呼び出されます。 たとえば、サービスに 4 つのエンドポイントがあり、そのうちの 2 つのリッスン URI が同じである場合は、このメソッドが 3 回呼び出されます。 これは、bindingParameters が各チャネル スタックをターゲットとし、リッスン URI ごとに 1 つのチャネル スタックが存在するからです。 呼び出しごとにそのリッスン URI のエンドポイントが取得されるため、2 回の呼び出しでそれぞれ 1 つの System.ServiceModel.Description.ServiceEndpoint が取得され、1 回の呼び出しで 2 つの System.ServiceModel.Description.ServiceEndpoint オブジェクトのコレクションが取得されます。

注意

すべての IServiceBehavior メソッドは System.ServiceModel.Description.ServiceDescription オブジェクトおよび System.ServiceModel.ServiceHostBase オブジェクトをパラメーターとして渡します。 ServiceDescription パラメーターは、カスタマイズの検査および挿入にのみ使用されます。それ以外でこれらのオブジェクトを変更した場合、実行動作は未定義になります。

適用対象