ApplicationSettingsBase.Item[String] Proprietà

Definizione

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

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

Valore della proprietà

Se trovato, il valore della proprietà delle impostazioni denominate; in caso contrario, null.

Eccezioni

Non sono presenti proprietà associate al wrapper corrente o non è stato possibile trovare la proprietà specificata.

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

Il valore fornito è di un tipo incompatibile con la proprietà settings, durante un'operazione di impostazione.

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 viene generato l'evento PropertyChanged .

Si applica a

Vedi anche