Funzione SaveSetting

Articolo
09/12/2008

Aggiornamento: novembre 2007

Salva o crea una voce relativa all'applicazione nel Registro di sistema di Windows.

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

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Parametri

AppName
Obbligatorio. Espressione String contenente il nome dell'applicazione o del progetto a cui viene applicata l'impostazione.
Section
Obbligatorio. Espressione String contenente il nome della sezione in cui viene salvata l'impostazione di chiave.
Key
Obbligatorio. Espressione String contenente il nome dell'impostazione di chiave salvata.
Setting
Obbligatorio. Espressione contenente il valore su cui viene impostato il parametro Key.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Non è stato possibile creare la chiave del Registro di sistema, 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

La funzione SaveSetting aggiunge la chiave a HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Se per qualche motivo non è possibile salvare l'impostazione di chiave, viene generato un errore.

Affinché SaveSetting funzioni, è necessario che sia presente un utente connesso in quanto tale funzione opera nella chiave del Registro di sistema HKEY_LOCAL_USER, che diventa attiva solo quando un utente esegue l'accesso in modo interattivo.

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.

SaveSetting richiede le autorizzazioni del Registro di sistemaWrite e Create.

Esempio

Nell'esempio riportato di seguito viene utilizzata prima la funzione SaveSetting per creare voci nel Registro di sistema di Windows per l'applicazione MyApp, quindi viene utilizzata la funzione DeleteSetting per rimuoverle.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")