SettingsBase.Item[String] Propriedade

Definição

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

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };
public virtual object this[string propertyName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overridable Property Item(propertyName As String) As Object

Parâmetros

propertyName
String

A contendo String o nome da propriedade a aceder.

Valor de Propriedade

Se for encontrado, o valor da propriedade de definições nomeadas.

Exceções

Não existem propriedades associadas ao objeto 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.

Observações

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

Na primeira vez que uma propriedade é acedida, a SettingsBase instância encontrará todas as outras propriedades que partilham o mesmo fornecedor que a propriedade solicitada. A SettingsBase instância irá então chamar o fornecedor, passando-lhe o conjunto de SettingsProperty objetos que representam os dados que o fornecedor deve recuperar.

Note que o indexador irá obter e definir dados de propriedades de forma thread-safe se IsSynchronized for true. Uma SettingsBase instância, por defeito, não é segura para threads. No entanto, pode chamar Synchronized, passando uma SettingsBase instância para fazer o SettingsBase indexador operar de forma segura para threads.

Aplica-se a

Ver também