ApplicationSettingsBase.Item[String] Propriedade

Definição

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

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

Exceções

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

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

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

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.

Aplica-se a

Confira também