SettingsBase.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:

SettingsBase.cs

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

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

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

Wartość właściwości

Object

Jeśli zostanie znaleziona, wartość właściwości nazwanych ustawień.

Wyjątki

SettingsPropertyNotFoundException

Nie ma żadnych właściwości skojarzonych z bieżącym obiektem 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

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

Uwagi

Właściwość Item[] , znana również jako indeksator, jest rutynowo używana w klasie ustawień pochodzącej z SettingsBaseklasy . Właściwość Item[] wiąże właściwość publiczną klasy z odpowiednią właściwością settings.

Przy pierwszym uzyskiwaniu dostępu do SettingsBase właściwości wystąpienie znajdzie wszystkie inne właściwości, które współużytkują tego samego dostawcę co żądana właściwość. Następnie SettingsBase wystąpienie wywoła dostawcę, przekazując mu zestaw SettingsProperty obiektów reprezentujących dane, które dostawca powinien pobrać.

Należy pamiętać, że indeksator pobierze i ustawi dane właściwości w bezpieczny wątkowo sposób, jeśli IsSynchronized jest to true. Domyślnie SettingsBase wystąpienie nie jest bezpieczne wątkiem. Można jednak wywołać metodę SynchronizedSettingsBase , przekazując wystąpienie, aby SettingsBase indeksator działał w sposób bezpieczny wątkowo.

Zobacz też

• IsReadOnly