SettingsBase.Item[String] Eigenschaft

Definition

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

propertyName
String

A String containing the name of the property to access.

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.

Gilt für:

Weitere Informationen