Funzione GetSetting

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce il valore di un'impostazione di chiave dalla voce del Registro di sistema di Windows relativa a un'applicazione.

Nelle operazioni del Registro di sistema la funzionalità My offre un più elevato livello di produttività e prestazioni rispetto a GetAllSettings . Per ulteriori informazioni, vedere Oggetto My.Computer.Registry.

Public Function GetSetting( _
   ByVal AppName As String, _
   ByVal Section As String, _
   ByVal Key As String, _
   Optional ByVal Default As String = "" _
) As String

Parametri

AppName
Obbligatorio. Espressione String contenente il nome dell'applicazione o del progetto per il quale viene richiesta l'impostazione di chiave.
Section
Obbligatorio. Espressione String contenente il nome della sezione nella quale viene individuata l'impostazione di chiave.
Key
Obbligatorio. Espressione String contenente il nome dell'impostazione di chiave da restituire.
Default
Facoltativo. Espressione contenente il valore da restituire quando per Key non è impostato alcun valore. Se omessa, Default verrà considerato come stringa di lunghezza zero ("").

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Uno o più argomenti non sono espressioni String oppure l'utente non è connesso.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se uno qualsiasi degli elementi denominati negli argomenti GetSetting non esiste, il valore restituito da GetSetting corrisponderà a Default.

Poiché la funzione GetSetting opera nella chiave del Registro di sistema HKEY_LOCAL_USER, che diventa attiva solo quando un utente esegue l'accesso in modo interattivo, è necessario che sia presente un utente connesso.

Le impostazioni del Registro di sistema a cui accedere da un processo non interattivo, ad esempio Mtx.exe, devono essere memorizzate nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\Software\ o HKEY_USER\DEFAULT\Software.

GetSetting richiede l'autorizzazione del Registro di sistemaRead.

Esempio

Nell'esempio riportato di seguito viene prima utilizzata la funzione SaveSetting per creare voci nel Registro di sistema di Windows per l'applicazione specificata come AppName, quindi viene utilizzata la funzione GetSetting per visualizzare una delle impostazioni. Essendo specificato l'argomento Default, verrà certamente restituito un valore. Tenere presente che i nomi di Section non possono essere recuperati con GetSetting. La funzione DeleteSetting rimuove infine tutte le voci dell'applicazione.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")