SettingsBase.Item[String] Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

SettingsBase.cs

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

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public virtual object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overridable Property Item(propertyName As String) As Object

Parametry

propertyName

String

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

Hodnota vlastnosti

Object

Pokud je nalezena hodnota pojmenované vlastnosti settings.

Výjimky

SettingsPropertyNotFoundException

K aktuálnímu objektu 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í.

Poznámky

Vlastnost Item[] , označovaná také jako indexer, se běžně používá ve třídě nastavení odvozené z SettingsBase. Vlastnost Item[] sváže veřejnou vlastnost třídy s odpovídající vlastností nastavení.

Při prvním přístupu k SettingsBase vlastnosti instance najde všechny ostatní vlastnosti, které sdílejí stejného zprostředkovatele jako požadovaná vlastnost. Instance SettingsBase pak zavolá zprostředkovatele a předá mu sadu SettingsProperty objektů, které představují data, která by měl zprostředkovatel načíst.

Všimněte si, že indexer získá a nastaví data vlastností bezpečným způsobem, pokud IsSynchronized je true. Instance SettingsBase ve výchozím nastavení není bezpečná z více vláken. Můžete však volat Synchronizeda předat SettingsBase instanci, aby SettingsBase indexer fungoval bezpečným způsobem z více vláken.

Viz také

• IsReadOnly