SettingsBase.Item[String] Propriété

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsBase.cs

Obtient ou définit la valeur de la propriété de paramètres 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 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

Paramètres

propertyName

String

String contenant le nom de la propriété à accéder.

Valeur de propriété

Object

Si elle est trouvée, valeur de la propriété de paramètres nommée.

Exceptions

SettingsPropertyNotFoundException

Il n'y a pas de propriété associée à l'objet 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.

Remarques

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

La première fois qu’une propriété est consultée, l’instance SettingsBase recherche toutes les autres propriétés qui partagent le même fournisseur que la propriété demandée. Le SettingsBase instance appelle ensuite le fournisseur, en lui transmettant l’ensemble d’objets SettingsProperty qui représentent les données que le fournisseur doit récupérer.

Notez que l’indexeur obtient et définit les données de propriété de manière thread-safe si IsSynchronized est true. Un SettingsBase instance par défaut n’est pas thread safe. Toutefois, vous pouvez appeler Synchronized, en passant un SettingsBase instance pour que l’indexeur SettingsBase fonctionne de manière thread-safe.

Voir aussi

• IsReadOnly