IServiceBehavior.AddBindingParameters 方法

定義

命名空間:

System.ServiceModel.Description

組件:

System.ServiceModel.dll

提供將自訂資料傳遞到繫結項目以支援合約實作的功能。

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 呼叫一次。 例如，如果服務有四個端點，其中兩個具有相同的接聽 URI，便會呼叫這個方法三次。 這是因為 bindingParameters 是以每個通道堆疊為目標，且每個接聽 URI 都有一個通道堆疊。 由於每個呼叫都會收到該接聽 URI 上的這些端點，因此兩個呼叫會分別取得單一 System.ServiceModel.Description.ServiceEndpoint，而一個呼叫會取得兩個 System.ServiceModel.Description.ServiceEndpoint 物件的集合。

注意

所有的 IServiceBehavior 方法都會傳遞 System.ServiceModel.Description.ServiceDescription 和 System.ServiceModel.ServiceHostBase 物件當做參數。 ServiceDescription 參數僅供檢查和插入自訂項目；如果您要修改這些物件，就無法定義執行行為。