ApplicationSettingsBase.Item[String] Propriedade

Definição

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

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 de configurações nomeadas; caso contrário, null.

Exceções

Não foi possível encontrar nenhuma propriedade associada ao wrapper atual ou à propriedade especificada.

Foi feita uma tentativa de definir uma propriedade somente leitura.

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

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 é acionado. 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