SettingsBase.Item[String] Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Jeśli zostanie znaleziona, wartość właściwości nazwanych ustawień.
Wyjątki
Nie ma żadnych właściwości skojarzonych z bieżącym obiektem lub nie można odnaleźć określonej właściwości.
Podjęto próbę ustawienia właściwości tylko do odczytu.
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.