ApplicationSettingsBase.Item[String] Propriedade

Definição

Obtém ou define o valor da propriedade de definições da aplicação 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

A contendo String o nome da propriedade a aceder.

Valor de Propriedade

Se encontrado, o valor da propriedade de definições nomeadas; caso contrário, null.

Exceções

Não existem propriedades associadas ao envelope atual ou a propriedade especificada não foi encontrada.

Foi feita uma tentativa de definir uma propriedade de apenas leitura.

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

O ficheiro de configuração não podia ser analisado.

Observações

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

Item[] levanta vários eventos dependendo da operação realizada:

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

  • Quando uma propriedade é definida, o OnSettingChanging evento é elevado. Se o handler não cancelar o evento, então o valor da propriedade é definido e o PropertyChanged evento é elevado.

Aplica-se a

Ver também