ChannelFactory.ApplyConfiguration(String) Method

Reference

Definition

Namespace:: System.ServiceModel

Assemblies:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

protected:
 virtual void ApplyConfiguration(System::String ^ configurationName);

protected virtual void ApplyConfiguration(string configurationName);

abstract member ApplyConfiguration : string -> unit
override this.ApplyConfiguration : string -> unit

Protected Overridable Sub ApplyConfiguration (configurationName As String)

Parameters

configurationName: String

The name of the configuration file.

Exceptions

InvalidOperationException

The service endpoint of the channel factory is null.

Remarks

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 WCF Client Configuration topic for a discussion of the client configuration.

Applies to

Produit	Versions
.NET	Core 1.0, Core 1.1
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
UWP	10.0

Partager via