ApplicationSettingsBase.Item[String] Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.dll

Pacchetto:: System.Configuration.ConfigurationManager v6.0.0

Pacchetto:: System.Configuration.ConfigurationManager v7.0.0

Pacchetto:: System.Configuration.ConfigurationManager v8.0.0

Pacchetto:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Origine:: ApplicationSettingsBase.cs

Origine:: ApplicationSettingsBase.cs

Origine:: ApplicationSettingsBase.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

Si applica a

Prodotto	Versioni
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Condividi tramite