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.
Dient zum Abrufen oder Festlegen des Werts der angegebenen Einstellungseigenschaft.
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 benannten Einstellungseigenschaft.
Ausnahmen
Dem aktuellen Objekt sind keine Eigenschaften zugeordnet, oder die angegebene Eigenschaft konnte nicht gefunden werden.
Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.
Der angegebene Wert weist einen Typ auf, der während eines Set-Vorgangs nicht mit der Einstellungseigenschaft kompatibel ist.
Hinweise
Die Item[] Eigenschaft, auch als Indexer bezeichnet, wird routinemäßig in der Einstellungsklasse verwendet, die von SettingsBase. Die Item[] Eigenschaft bindet die öffentliche Eigenschaft der Klasse an die entsprechende Einstellungseigenschaft.
Beim ersten Zugriff auf eine Eigenschaft findet die SettingsBase Instanz alle anderen Eigenschaften, die denselben Anbieter wie die angeforderte Eigenschaft verwenden. Die SettingsBase Instanz 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 bei Bedarf IsSynchronizedEigenschaftendaten in threadsicherer Weise true abrufen und festlegen wird. Eine SettingsBase Instanz ist standardmäßig nicht threadsicher. Sie können jedoch aufrufen Synchronizedund eine SettingsBase Instanz übergeben, damit der SettingsBase Indexer threadsicher ausgeführt wird.