SettingsBase.Item[String] Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsBase.cs

Ottiene o imposta il valore della proprietà di impostazione specificata.

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

Parametri

propertyName

String

Classe String contenente il nome della proprietà a cui accedere.

Valore della proprietà

Object

Se presente, valore della proprietà di impostazione denominata.

Eccezioni

SettingsPropertyNotFoundException

Nessuna proprietà è associata all'oggetto corrente oppure è impossibile trovare la proprietà specificata.

SettingsPropertyIsReadOnlyException

È stato effettuato un tentativo di impostazione di una proprietà in sola lettura.

SettingsPropertyWrongTypeException

Il valore specificato è di tipo non compatibile con la proprietà delle impostazioni, durante un'operazione di impostazione.

Commenti

La Item[] proprietà, nota anche come indicizzatore, viene usata in modo routine nella classe impostazioni derivata da SettingsBase. La Item[] proprietà associa la proprietà pubblica della classe alla proprietà impostazioni corrispondente.

La prima volta che si accede a una proprietà, l'istanza SettingsBase troverà tutte le altre proprietà che condividono lo stesso provider della proprietà richiesta. L'istanza SettingsBase chiamerà quindi il provider, passandolo il set di SettingsProperty oggetti che rappresentano i dati che il provider deve recuperare.

Si noti che l'indicizzatore otterrà e imposta i dati delle proprietà in modo thread-safe se IsSynchronized è true. Un'istanza SettingsBase per impostazione predefinita non è thread safe. Tuttavia, è possibile chiamare Synchronized, passando un'istanza SettingsBase per rendere l'indicizzatore SettingsBase opera in modo thread-safe.

Vedi anche

• IsReadOnly