IServiceBehavior.AddBindingParameters 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
用于向绑定元素传递自定义数据,以支持协定实现。
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 参数仅用于自定义检查和插入;如果您修改了这些对象,则执行行为将不确定。