ApplicationSettingsBase.Item[String] Propriété

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

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é

Object

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

Exceptions

SettingsPropertyNotFoundException

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

SettingsPropertyIsReadOnlyException

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

SettingsPropertyWrongTypeException

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

ConfigurationErrorsException

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é.

Voir aussi

• Properties
• IsReadOnly