ChannelFactory::ApplyConfiguration Method (String^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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:
virtual void ApplyConfiguration(
	String^ configurationName
)

Parameters

configurationName
Type: System::String^

The name of the configuration file.

Exception Condition
InvalidOperationException

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
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: