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


Initializes the provider.

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

virtual void Initialize(
	String^ name,
	NameValueCollection^ config


Type: System::String^

The friendly name of the provider.

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

The name of the provider is null.


The name of the provider has a length of zero.


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