ApplicationSettingsBase.Item[String] Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ApplicationSettingsBase.cs

Ruft den Wert der angegebenen Anwendungseinstellungseigenschaft ab oder legt diesen fest.

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

Parameter

propertyName

String

Ein String, der den Namen der aufzurufenden Eigenschaft enthält.

Eigenschaftswert

Object

Wenn gefunden, der Wert der genannten Einstellungseigenschaft; andernfalls, null.

Ausnahmen

SettingsPropertyNotFoundException

Es gibt keine dem aktuellen Wrapper zugeordnete Eigenschaften, oder die angegebene Eigenschaft konnte nicht gefunden werden.

SettingsPropertyIsReadOnlyException

Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.

SettingsPropertyWrongTypeException

Der angegebene Wert ist von einem Typ, der mit der Einstellungseigenschaft während einer Set-Operation nicht kompatibel ist.

ConfigurationErrorsException

Die Konfigurationsdatei konnte nicht analysiert werden.

Hinweise

Die Item[] Eigenschaft, auch als Indexer bezeichnet, wird routinemäßig in der von ApplicationSettingsBaseabgeleiteten Wrapperklasse für Einstellungen verwendet. Item[] bindet die öffentliche Eigenschaft der Wrapperklasse an die entsprechende einstellungseigenschaft.

Item[] löst je nach ausgeführter Operation mehrere Ereignisse aus:

• Wenn eine Eigenschaft zum ersten Mal abgerufen wird, wird das SettingsLoaded Ereignis ausgelöst.

• Wenn eine -Eigenschaft festgelegt wird, wird das OnSettingChanging -Ereignis ausgelöst. Wenn der Handler das Ereignis nicht abbricht, wird der Eigenschaftswert festgelegt, und das PropertyChanged Ereignis wird ausgelöst.

Weitere Informationen

• Properties
• IsReadOnly