ApplicationSettingsBase.Item[String] Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ApplicationSettingsBase.cs

Pobiera lub ustawia wartość określonej właściwości ustawień aplikacji.

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

Parametry

propertyName

String

Obiekt String zawierający nazwę właściwości, do których ma być uzyskiwany dostęp.

Wartość właściwości

Object

Jeśli zostanie znaleziona, wartość nazwanej właściwości ustawień; w przeciwnym razie , null.

Wyjątki

SettingsPropertyNotFoundException

Nie ma żadnych właściwości skojarzonych z bieżącą otoczką lub nie można odnaleźć określonej właściwości.

SettingsPropertyIsReadOnlyException

Podjęto próbę ustawienia właściwości tylko do odczytu.

SettingsPropertyWrongTypeException

Podana wartość jest typu niezgodnego z właściwością settings podczas operacji zestawu.

ConfigurationErrorsException

Nie można przeanalizować pliku konfiguracji.

Uwagi

Właściwość Item[] , znana również jako indeksator, jest rutynowo używana w klasie otoki ustawień pochodzącej z ApplicationSettingsBaseklasy . Item[] Tworzy powiązanie właściwości publicznej klasy otoki z odpowiednią właściwością settings.

Item[] wywołuje kilka zdarzeń w zależności od wykonywanej operacji:

• Przy pierwszym pobraniu SettingsLoaded właściwości zdarzenie jest zgłaszane.

• Po ustawieniu OnSettingChanging właściwości zdarzenie jest zgłaszane. Jeśli program obsługi nie anuluje zdarzenia, zostanie ustawiona wartość właściwości i PropertyChanged zostanie zgłoszone zdarzenie.

Zobacz też

• Properties
• IsReadOnly