ApplicationSettingsBase.Item[String] Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.