SettingsBase.Item[String] Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert der angegebenen Einstellungseigenschaft ab oder legt diesen fest.
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
Parameter
Eigenschaftswert
Wenn gefunden, der Wert der genannten Einstellungseigenschaft.
Ausnahmen
Es gibt keine dem aktuellen Objekt zugeordnete Eigenschaften, oder die angegebene Eigenschaft konnte nicht gefunden werden.
Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.
Der angegebene Wert ist von einem Typ, der mit der Einstellungseigenschaft während einer Set-Operation nicht kompatibel ist.
Hinweise
Die Item[] Eigenschaft, auch als Indexer bezeichnet, wird routinemäßig in der von SettingsBaseabgeleiteten Einstellungsklasse verwendet. Die Item[] -Eigenschaft bindet die öffentliche Eigenschaft der -Klasse an die entsprechende Einstellungseigenschaft.
Wenn zum ersten Mal auf eine Eigenschaft zugegriffen wird, findet der SettingsBase instance alle anderen Eigenschaften, die denselben Anbieter wie die angeforderte Eigenschaft verwenden. Der SettingsBase instance ruft dann den Anbieter auf und übergibt ihn den Satz von SettingsProperty Objekten, die die Daten darstellen, die der Anbieter abrufen soll.
Beachten Sie, dass der Indexer Eigenschaftendaten threadsicher abrufen und festlegen wird, wenn IsSynchronized ist true
. Ein SettingsBase instance ist standardmäßig nicht threadsicher. Sie können jedoch aufrufenSynchronized, indem Sie eine SettingsBase instance übergeben, damit der SettingsBase Indexer threadsicher ausgeführt wird.