• Article

ChannelFactory.ApplyConfiguration Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Protected Overridable Sub ApplyConfiguration ( _
    configurationName As String _
)

protected virtual void ApplyConfiguration(
    string configurationName
)

Parameters

  • configurationName
    Type: System.String
    The name of the configuration file.

Exceptions

Exception Condition
InvalidOperationException

The service endpoint of the channel factory is nulla null reference (Nothing in Visual Basic).

Remarks

If configurationName is nulla null reference (Nothing in Visual Basic), 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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.