SettingsBase.Item[String] Propriedade

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

SettingsBase.cs

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

Um String que contém o nome da propriedade a ser acessada.

Valor da propriedade

Object

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

Exceções

SettingsPropertyNotFoundException

Não há nenhuma propriedade associada ao objeto atual ou a propriedade especificada não pôde ser encontrada.

SettingsPropertyIsReadOnlyException

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

SettingsPropertyWrongTypeException

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

Comentários

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

Na primeira vez que uma propriedade for acessada, a SettingsBase instância encontrará todas as outras propriedades que compartilham o mesmo provedor que a propriedade solicitada. Em SettingsBase seguida, a instância chamará o provedor, passando-lhe o conjunto de SettingsProperty objetos que representam os dados que o provedor deve recuperar.

Observe que o indexador obterá e definirá dados de propriedade de maneira thread-safe se IsSynchronized for true. Por padrão, uma SettingsBase instância não é thread-safe. No entanto, você pode chamar Synchronized, passando uma SettingsBase instância para fazer com que o SettingsBase indexador opere de maneira thread-safe.

Confira também

• IsReadOnly