ApplicationSettingsBase.Item[String] Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

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

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

Hodnota vlastnosti

Object

Pokud je nalezena hodnota pojmenované settings vlastnost; v opačném případě . null

Výjimky

SettingsPropertyNotFoundException

K aktuální obálek 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ího s vlastností settings během operace nastavení.

ConfigurationErrorsException

Konfigurační soubor nelze analyzovat.

Poznámky

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

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

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

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

Viz také

• Properties
• IsReadOnly