ProviderBase.Initialize(String, NameValueCollection) Método

Definição

Namespace:

System.Configuration.Provider

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ProviderBase.cs

Inicializa o construtor de configuração.

public:
 virtual void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config);

public virtual void Initialize (string name, System.Collections.Specialized.NameValueCollection config);

abstract member Initialize : string * System.Collections.Specialized.NameValueCollection -> unit
override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit

Public Overridable Sub Initialize (name As String, config As NameValueCollection)

Parâmetros

name

String

O nome amigável do provedor.

config

NameValueCollection

Uma coleção dos pares nome-valor que representam os atributos específicos do provedor especificados na configuração para esse provedor.

Exceções

ArgumentNullException

O nome do provedor é null.

ArgumentException

O nome do provedor tem tamanho zero.

InvalidOperationException

É feita uma tentativa para chamar Initialize(String, NameValueCollection) em um provedor depois que o provedor já foi inicializado.

Exemplos

Para obter um exemplo de como usar Initialize, consulte Exemplo de implementação do provedor de perfil.

Comentários

A implementação da classe base controla internamente o número de vezes que o método do Initialize provedor foi chamado. Se um provedor for inicializado mais de uma vez, um InvalidOperationException será lançado informando que o provedor já está inicializado.

Como a maioria dos provedores de recursos chama Initialize antes de executar a inicialização específica do provedor, esse método é um local central para impedir a inicialização dupla.

Confira também

• Exemplo de implementação do provedor de perfil
• Exemplo de implementação do provedor de configuração protegido
• Como: implementação do provedor de associação de exemplo
• Como: exemplo de implementação de Role-Provider