SettingsBase.Item[String] Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarde van de opgegeven instellingeneigenschap op of stelt u deze in.
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, setDefault Public Overridable Property Item(propertyName As String) As ObjectParameters
Waarde van eigenschap
Als deze wordt gevonden, is de waarde van de eigenschap benoemde instellingen.
Uitzonderingen
Er zijn geen eigenschappen gekoppeld aan het huidige object of de opgegeven eigenschap is niet gevonden.
Er is een poging gedaan om een eigenschap met het kenmerk Alleen-lezen in te stellen.
De opgegeven waarde is van een type dat niet compatibel is met de eigenschap Instellingen, tijdens een ingestelde bewerking.
Opmerkingen
De Item[] eigenschap, ook wel de indexeerfunctie genoemd, wordt regelmatig gebruikt in de instellingenklasse die is afgeleid van SettingsBase. De Item[] eigenschap verbindt de openbare eigenschap van de klasse met de bijbehorende instellingeneigenschap.
De eerste keer dat een eigenschap wordt geopend, vindt het SettingsBase exemplaar alle andere eigenschappen die dezelfde provider delen als de aangevraagde eigenschap. Vervolgens SettingsBase roept het exemplaar de provider aan, waarbij deze de set SettingsProperty objecten doorgeeft die de gegevens vertegenwoordigen die de provider moet ophalen.
Houd er rekening mee dat de indexeerfunctie eigenschapsgegevens op een threadveilige manier opneemt en instelt als IsSynchronized dat het is true. Een SettingsBase exemplaar is standaard niet threadveilig. U kunt echter een exemplaar aanroepen Synchronizeden doorgeven SettingsBase om de SettingsBase indexeerfunctie op een threadveilige manier te laten werken.