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 都调用一次该方法。 例如,如果一个服务有四个终结点,其中两个终结点的侦听 URI 相同,则此方法将会被调用三次。 原因是,bindingParameters 要定位所有通道堆栈,每个侦听 URI 都有一个通道堆栈。 因为每个调用都要在侦听 URI 接收这些终结点,所以有两个调用将会各自获得一个单独的 System.ServiceModel.Description.ServiceEndpoint,另一个调用将会获得两个 System.ServiceModel.Description.ServiceEndpoint 对象的集合。

备注

所有 IServiceBehavior 方法会将 System.ServiceModel.Description.ServiceDescriptionSystem.ServiceModel.ServiceHostBase 对象作为参数传递。 ServiceDescription 参数仅用于自定义检查和插入;如果您修改了这些对象,则执行行为将不确定。

适用于