ApplicationSettingsBase.Item[String] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.