ApplicationSettingsBase.Item[String] Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

Zdroj:

ApplicationSettingsBase.cs

Získá nebo nastaví hodnotu zadané vlastnosti nastavení aplikace.

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

A String obsahující název vlastnosti pro přístup.

Hodnota vlastnosti

Object

Pokud se najde, hodnota pojmenované vlastnosti nastavení; v opačném případě . null

Výjimky

SettingsPropertyNotFoundException

K aktuálnímu obálku nejsou přidruženy žádné vlastnosti nebo zadaná vlastnost nebyla nalezena.

SettingsPropertyIsReadOnlyException

Došlo k pokusu o nastavení vlastnosti jen pro čtení.

SettingsPropertyWrongTypeException

Zadaná hodnota je typu nekompatibilní s vlastností nastavení během operace set.

ConfigurationErrorsException

Konfigurační soubor nelze analyzovat.

Poznámky

Vlastnost Item[] , označovaná také jako indexer, se běžně používá v zabalovací třídě nastavení odvozené z ApplicationSettingsBase. Item[] vytvoří vazbu veřejné vlastnosti třídy obálky na odpovídající vlastnost nastavení.

Item[] vyvolá několik událostí v závislosti na prováděné operaci:

• Při prvním načtení SettingsLoaded vlastnosti se vyvolá událost.

• Při nastavení OnSettingChanging vlastnosti je vyvolána událost. Pokud obslužná rutina událost nezruší, nastaví se hodnota vlastnosti a PropertyChanged vyvolá se událost.

Viz také

• Properties
• IsReadOnly