Partage via


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.

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.

Valeur de propriété

Si elle est trouvée, correspond au nom de la propriété de paramètres nommée ; sinon, null.

Exceptions

Il n'y a pas de propriété associée au wrapper actuel ou la propriété spécifiée est introuvable.

Une tentative de définition de propriété en lecture seule a été effectuée.

La valeur fournie est d'un type incompatible avec la propriété de paramètres, durant une opération de définition.

Le fichier de configuration n'a pas pu être analysé.

Remarques

La Item[] propriété, également appelée indexeur, est couramment utilisée dans la classe wrapper de paramètres dérivée de ApplicationSettingsBase. Item[] lie la propriété publique de la classe wrapper à la propriété settings correspondante.

Item[] déclenche plusieurs événements en fonction de l’opération en cours d’exécution :

  • La première fois qu’une propriété est récupérée, l’événement SettingsLoaded est déclenché.

  • Lorsqu’une propriété est définie, l’événement OnSettingChanging est déclenché. Si le gestionnaire n’annule pas l’événement, la valeur de la propriété est définie et l’événement PropertyChanged est déclenché.

S’applique à

Voir aussi