Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ProviderBase::Initialize Method (String^, NameValueCollection^)

 

Initializes the provider.

Namespace:   System.Configuration.Provider
Assembly:  System.Configuration (in System.Configuration.dll)

public:
virtual void Initialize(
	String^ name,
	NameValueCollection^ config
)

Parameters

name
Type: System::String^

The friendly name of the provider.

config
Type: System.Collections.Specialized::NameValueCollection^

A collection of the name/value pairs representing the provider-specific attributes specified in the configuration for this provider.

Exception Condition
ArgumentNullException

The name of the provider is null.

ArgumentException

The name of the provider has a length of zero.

InvalidOperationException

An attempt is made to call Initialize on a provider after the provider has already been initialized.

The base class implementation internally tracks the number of times the provider's Initialize method has been called. If a provider is initialized more than once, an InvalidOperationException is thrown stating that the provider is already initialized.

Because most feature providers call Initialize prior to performing provider-specific initialization, this method is a central location for preventing double initialization.

For an example of how to use Initialize, see Profile Provider Implementation Example.

.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft