ApplicationSettingsBase.Item[String] Eigenschaft

Definition

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

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

Ausnahmen

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

Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.

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

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.

Gilt für:

Weitere Informationen