ApplicationSettingsBase.Item[String] Eigenschap

Definitie

Hiermee haalt u de waarde van de opgegeven eigenschap voor toepassingsinstellingen op of stelt u deze in.

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

Parameters

propertyName
String

Een String met de naam van de eigenschap voor toegang.

Waarde van eigenschap

Indien gevonden, de waarde van de eigenschap benoemde instellingen; anders, null.

Uitzonderingen

Er zijn geen eigenschappen gekoppeld aan de huidige wrapper of de opgegeven eigenschap is niet gevonden.

Er is een poging gedaan om een eigenschap met het kenmerk Alleen-lezen in te stellen.

De opgegeven waarde is van een type dat niet compatibel is met de eigenschap Instellingen, tijdens een ingestelde bewerking.

Het configuratiebestand kan niet worden geparseerd.

Opmerkingen

De Item[] eigenschap, ook wel de indexeerfunctie genoemd, wordt regelmatig gebruikt in de instellingen wrapperklasse die is afgeleid van ApplicationSettingsBase. Item[] verbindt de openbare eigenschap van de wrapper-klasse met de bijbehorende instellingeneigenschap.

Item[] genereert verschillende gebeurtenissen, afhankelijk van de bewerking die wordt uitgevoerd:

  • De eerste keer dat een eigenschap wordt opgehaald, wordt de SettingsLoaded gebeurtenis gegenereerd.

  • Wanneer een eigenschap is ingesteld, wordt de OnSettingChanging gebeurtenis gegenereerd. Als de handler de gebeurtenis niet annuleert, wordt de eigenschapswaarde ingesteld en wordt de PropertyChanged gebeurtenis gegenereerd.

Van toepassing op

Zie ook