SettingsBase.Item[String] Eigenschaft

Definition

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

propertyName
String

Ein String, der den Namen der aufzurufenden Eigenschaft enthält.

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.

Gilt für:

Weitere Informationen