SettingsBase.Item[String] Propriedade

Definição

Obtém ou define o valor da propriedade de configurações especificada.Gets or sets the value of the specified settings property.

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.A String containing the name of the property to access.

Valor da propriedade

Object

Se for encontrado, o valor da propriedade de configurações nomeadas.If found, the value of the named settings property.

Exceções

Não há nenhuma propriedade associada ao objeto atual ou a propriedade especificada não pôde ser encontrada.There are no properties associated with the current object, or the specified property could not be found.

Foi feita uma tentativa de definir esta propriedade como somente leitura.An attempt was made to set a read-only property.

O valor fornecido é de um tipo incompatível com a propriedade das configurações durante uma operação de conjuntos.The value supplied is of a type incompatible with the settings property, during a set operation.

Comentários

A Item[] propriedade, também conhecida como indexador, é usada rotineiramente na classe de configurações derivada de SettingsBase .The Item[] property, also known as the indexer, is routinely used in the settings class derived from SettingsBase. A Item[] propriedade associa a propriedade pública da classe à propriedade de configurações correspondente.The Item[] property binds the public property of the class to the corresponding settings property.

Na primeira vez que uma propriedade for acessada, a SettingsBase instância localizará todas as outras propriedades que compartilham o mesmo provedor da propriedade solicitada.The first time a property is accessed, the SettingsBase instance will find all other properties that share the same provider as the requested property. SettingsBaseEm seguida, a instância chamará o provedor, passando-o para o conjunto de SettingsProperty objetos que representam os dados que o provedor deve recuperar.The SettingsBase instance will then call the provider, passing it the set of SettingsProperty objects that represent the data the provider should retrieve.

Observe que o indexador obterá e definirá dados de propriedade de forma segura para thread, se IsSynchronized for true .Note that the indexer will get and set property data in a thread-safe manner if IsSynchronized is true. Uma SettingsBase instância por padrão não é thread-safe.A SettingsBase instance by default is not thread safe. No entanto, você pode chamar Synchronized , passando uma SettingsBase instância para fazer com que o SettingsBase indexador opere de maneira segura para thread.However, you can call Synchronized, passing in a SettingsBase instance to make the SettingsBase indexer operate in a thread-safe manner.

Aplica-se a

Confira também