IServiceBehavior::AddBindingParameters Method (ServiceDescription^, ServiceHostBase^, Collection<ServiceEndpoint^>^, BindingParameterCollection^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Provides the ability to pass custom data to binding elements to support the contract implementation.

Namespace:   System.ServiceModel.Description
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

void AddBindingParameters(
	ServiceDescription^ serviceDescription,
	ServiceHostBase^ serviceHostBase,
	Collection<ServiceEndpoint^>^ endpoints,
	BindingParameterCollection^ bindingParameters


Type: System.ServiceModel.Description::ServiceDescription^

The service description of the service.

Type: System.ServiceModel::ServiceHostBase^

The host of the service.

Type: System.Collections.ObjectModel::Collection<ServiceEndpoint^>^

The service endpoints.

Type: System.ServiceModel.Channels::BindingParameterCollection^

Custom objects to which binding elements have access.

Use the AddBindingParameters method to add custom data objects to the parameters collection that binding elements can use to acquire extra information to enable them to support the contract.

This method is called once for each listen URI. For example, if a service has four endpoints, and two of them have the same listen URI, then this method gets called three times. The reason is that the bindingParameters target each channel stack and there is one channel stack for each listen URI. Because each call receives those endpoints at that listen URI, two calls each get a single System.ServiceModel.Description::ServiceEndpoint, and one call gets a collection of two System.ServiceModel.Description::ServiceEndpoint objects.


All of the IServiceBehavior methods pass System.ServiceModel.Description::ServiceDescription and System.ServiceModel::ServiceHostBase objects as a parameters. The ServiceDescription parameter is for examination and insertion of customizations only; if you otherwise modify these objects the execution behavior is undefined.

.NET Framework
Available since 3.0
Return to top