ApplicationSettingsBase.Item[String] Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Ottiene o imposta il valore della proprietà delle impostazioni dell'applicazione specificata.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public override object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides 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, il valore della proprietà delle impostazioni denominata; in caso contrario, null.

Eccezioni

SettingsPropertyNotFoundException

Nessuna proprietà è associata al wrapper corrente oppure non è possibile 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.

ConfigurationErrorsException

Impossibile analizzare il file di configurazione.

Commenti

La Item[] proprietà , nota anche come indicizzatore, viene usata regolarmente nella classe wrapper delle impostazioni derivata da ApplicationSettingsBase. Item[] associa la proprietà pubblica della classe wrapper alla proprietà delle impostazioni corrispondente.

Item[] genera diversi eventi a seconda dell'operazione eseguita:

• La prima volta che viene recuperata una proprietà, viene generato l'evento SettingsLoaded .

• Quando viene impostata una proprietà, viene generato l'evento OnSettingChanging . Se il gestore non annulla l'evento, il valore della proprietà viene impostato e l'evento PropertyChanged viene generato.

Vedi anche

• Properties
• IsReadOnly