ApplicationSettingsBase.Item[String] Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Werts der angegebenen Anwendungseinstellungseigenschaft.

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

A String containing the name of the property to access.

Eigenschaftswert

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

Ausnahmen

Dem aktuellen Wrapper sind keine Eigenschaften zugeordnet, oder die angegebene Eigenschaft konnte nicht gefunden werden.

Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.

Der angegebene Wert weist einen Typ auf, der während eines Set-Vorgangs nicht mit der Einstellungseigenschaft kompatibel ist.

Die Konfigurationsdatei konnte nicht analysiert werden.

Hinweise

Die Item[] Eigenschaft, auch als Indexer bezeichnet, wird routinemäßig in der Einstellungswrapperklasse verwendet, die von ApplicationSettingsBase. 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 ausgelöst.

Gilt für:

Weitere Informationen