ChannelFactory.ApplyConfiguration Method (String)


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

Initializes the channel factory with the behaviors provided by a specified configuration file and with those in the service endpoint of the channel factory.

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

Protected Overridable Sub ApplyConfiguration (
	configurationName As String


Type: System.String

The name of the configuration file.

Exception Condition

The service endpoint of the channel factory is null.

If configurationName is null, only the behaviors specified in the service endpoint are loaded. If the wildcard, "*", is used, any endpoint configuration in the client configuration file is used, but only if there is precisely one. Otherwise an exception is thrown. Any other value for the configurationName, including the empty string "", matches the endpoint configuration with the same name. See the Client Configuration topic for a discussion of the client configuration.

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.0
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top