ApplicationSettingsBase.Item[String] Egenskap

Definition

Namnområde:
System.Configuration
Sammansättning:
System.dll

Hämtar eller anger värdet för den angivna egenskapen för programinställningar.

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

Parametrar

propertyName
String

A String som innehåller namnet på den egenskap som ska kommas åt.

Egenskapsvärde

Object

Om det hittas, värdet för egenskapen namngivna inställningar; annars . null

Undantag

SettingsPropertyNotFoundException

Det finns inga egenskaper som är associerade med den aktuella omslutningen eller så gick det inte att hitta den angivna egenskapen.

SettingsPropertyIsReadOnlyException

Ett försök gjordes att ange en skrivskyddad egenskap.

SettingsPropertyWrongTypeException

Det angivna värdet är av en typ som inte är kompatibel med inställningsegenskapen under en angiven åtgärd.

ConfigurationErrorsException

Det gick inte att parsa konfigurationsfilen.

Kommentarer

Egenskapen Item[] , även kallad indexeraren, används rutinmässigt i inställningsomslutningsklassen som härleds från ApplicationSettingsBase. Item[] binder den offentliga egenskapen för omslutningsklassen till motsvarande inställningsegenskap.

Item[] genererar flera händelser beroende på vilken åtgärd som utförs:

  • Första gången en egenskap hämtas utlöses SettingsLoaded händelsen.

  • När en egenskap har angetts OnSettingChanging utlöses händelsen. Om hanteraren inte avbryter händelsen anges egenskapsvärdet och PropertyChanged händelsen aktiveras.

Gäller för

Se även