SettingsBase.Item[String] Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

SettingsBase.cs

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

Object

Wenn gefunden, der Wert der genannten Einstellungseigenschaft.

Ausnahmen

SettingsPropertyNotFoundException

Es gibt keine dem aktuellen Objekt zugeordnete Eigenschaften, oder die angegebene Eigenschaft konnte nicht gefunden werden.

SettingsPropertyIsReadOnlyException

Es wurde versucht, eine schreibgeschützte Eigenschaft festzulegen.

SettingsPropertyWrongTypeException

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.

Weitere Informationen

• IsReadOnly