ApplicationSettingsBase.Item[String] Propriété

Définition

Obtient ou définit la valeur de la propriété de paramètres d'application spécifiée.Gets or sets the value of the specified application 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 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

Paramètres

propertyName
String

String contenant le nom de la propriété à accéder.A String containing the name of the property to access.

Valeur de propriété

Si elle est trouvée, correspond au nom de la propriété de paramètres nommée ; sinon, null.If found, the value of the named settings property; otherwise, null.

Exceptions

Il n'y a pas de propriété associée au wrapper actuel ou la propriété spécifiée est introuvable.There are no properties associated with the current wrapper or the specified property could not be found.

Une tentative de définition de propriété en lecture seule a été effectuée.An attempt was made to set a read-only property.

La valeur fournie est d'un type incompatible avec la propriété de paramètres, durant une opération de définition.The value supplied is of a type incompatible with the settings property, during a set operation.

Le fichier de configuration n'a pas pu être analysé.The configuration file could not be parsed.

Remarques

La Item[String] propriété, également appelée indexeur, est couramment utilisée dans la classe wrapper de paramètres dérivée de ApplicationSettingsBase.The Item[String] property, also known as the indexer, is routinely used in the settings wrapper class derived from ApplicationSettingsBase. Item[String]lie la propriété publique de la classe wrapper à la propriété de paramètres correspondante.Item[String] binds the public property of the wrapper class to the corresponding settings property.

Item[String]déclenche plusieurs événements en fonction de l’opération en cours d’exécution:Item[String] raises several events depending on the operation being performed:

  • La première fois qu’une propriété est récupérée, SettingsLoaded l’événement est déclenché.The first time a property is retrieved, the SettingsLoaded event is raised.

  • Quand une propriété est définie, l' OnSettingChanging événement est déclenché.When a property is set, the OnSettingChanging event is raised. Si le gestionnaire n’annule pas l’événement, la valeur de la propriété est définie PropertyChanged et l’événement est déclenché.If the handler does not cancel the event, then the property value is set and the PropertyChanged event is raised.

S’applique à

Voir aussi