ApplicationSettingsBase.Item[String] Propriedade

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ApplicationSettingsBase.cs

Obtém ou define o valor da propriedade especificada das configurações do aplicativo.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public override object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(propertyName As String) As Object

Parâmetros

propertyName

String

Um String que contém o nome da propriedade a ser acessada.

Valor da propriedade

Object

Se encontrado, o valor da propriedade das configurações nomeada; caso contrário, null.

Exceções

SettingsPropertyNotFoundException

Não existem propriedades associadas ao wrapper atual ou não foi possível encontrar a propriedade especificada.

SettingsPropertyIsReadOnlyException

Foi feita uma tentativa de definir esta propriedade como somente leitura.

SettingsPropertyWrongTypeException

O valor fornecido é de um tipo incompatível com a propriedade das configurações durante uma operação de conjuntos.

ConfigurationErrorsException

Não foi possível analisar o arquivo de configuração.

Comentários

A Item[] propriedade, também conhecida como indexador, é usada rotineiramente na classe wrapper de configurações derivada de ApplicationSettingsBase. Item[] associa a propriedade pública da classe wrapper à propriedade de configurações correspondente.

Item[] gera vários eventos dependendo da operação que está sendo executada:

• Na primeira vez que uma propriedade é recuperada, o SettingsLoaded evento é gerado.

• Quando uma propriedade é definida, o OnSettingChanging evento é gerado. Se o manipulador não cancelar o evento, o valor da propriedade será definido e o PropertyChanged evento será gerado.

Confira também

• Properties
• IsReadOnly