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órych 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.
Podana 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 ma wartość true. Wystąpienie SettingsBase domyślnie nie jest bezpieczne wątkiem. Można jednak wywołać Synchronizedmetodę SettingsBase , przekazując wystąpienie, aby SettingsBase indeksator działał w bezpieczny wątkowo sposób.