Funzione DeleteSetting

Articolo
09/12/2008

Aggiornamento: novembre 2007

Elimina una sezione o un'impostazione di chiave da una voce relativa a un'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 DeleteSetting . Per ulteriori informazioni, vedere Oggetto My.Computer.Registry.

Public Sub DeleteSetting( _
   ByVal AppName As String, _
   Optional ByVal Section As String = Nothing, _
   Optional ByVal Key As String = Nothing _
)

Parametri

AppName
Obbligatorio. Espressione String contenente il nome dell'applicazione o del progetto a cui viene applicata la sezione o l'impostazione di chiave.
Section
Obbligatorio. Espressione String contenente il nome della sezione da cui viene eliminata l'impostazione di chiave. Se vengono forniti solo i parametri AppName e Section, la sezione specificata viene eliminata insieme a tutte le impostazioni di chiave correlate.
Key
Facoltativo. Espressione String contenente il nome dell'impostazione di chiave eliminata.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	L'impostazione Section, AppName o Key non esiste.
ArgumentException	5	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 sono specificati tutti gli argomenti, l'impostazione specificata verrà eliminata. Se si utilizza l'istruzione DeleteSetting con una sezione o un'impostazione di sezione o di chiave non esistente, verrà generato un errore di runtime.

Affinché DeleteSetting 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.

Esempio

Nell'esempio riportato di seguito viene utilizzata prima la routine SaveSetting per creare delle voci nel Registro di sistema di Windows per l'applicazione MyApp, quindi viene utilizzata la funzione DeleteSetting per rimuoverle. Non essendo specificato alcun argomento Key, verrà eliminata l'intera sezione Startup, incluso il nome di sezione e tutte le relative chiavi.

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