Comment : définir les valeurs dans les clés de Registre dans Visual Basic
Mise à jour : novembre 2007
La méthode SetValue de l'objet My.Computer.Registry peut être utilisée pour écrire des valeurs dans le Registre de Windows. Le Registre contient des clés de niveau supérieur (ou racine) qui sont utilisées pour stocker des données. Par exemple, la clé racine HKEY_LOCAL_MACHINE est utilisée pour stocker des paramètres au niveau de l'ordinateur utilisés par tous les utilisateurs, tandis que HKEY_CURRENT_USER est utilisé pour stocker des données spécifiques à un utilisateur individuel.
La valeur, y compris le chemin d'accès complet à la clé, est créée si elle n'existe pas.
Procédure
Pour écrire une valeur dans une clé de Registre
Utilisez la méthode SetValue, en spécifiant la clé et la valeur. Cet exemple définit la valeur Name à "Author's Name" dans la clé HKEY_CURRENT_USER\Software\TestApp.
My.Computer.Registry.SetValue _ ("HKEY_CURRENT_USER\Software\TestApp", "Name", "Author's Name")
Cet exemple de code est également disponible sous forme d'extrait de code IntelliSense. Dans le sélecteur d'extrait de code, il se trouve dans Système d'exploitation Windows > Registre. Pour plus d'informations, consultez Comment : insérer des extraits de code dans votre code (Visual Basic).
Programmation fiable
Les données de préférence de l'utilisateur doivent être écrites dans la ruche Microsoft.Win32.Registry.CurrentUser.
Pour des raisons de sécurité, il est déconseillé de stocker des données confidentielles, telles que des mots de passe, en texte brut dans le Registre, même si la clé de Registre est protégée par des listes de contrôle d'accès (ACL, Access Control Lists).
Les conditions ci-dessous peuvent générer une exception.
Le nom de la clé est Nothing (ArgumentNullException).
Le nom de la clé dépasse la limite de 255 caractères (ArgumentException).
La ruche spécifiée n'est pas valide (ArgumentException).
La clé est fermée (IOException).
Le chemin d'accès n'est pas valide (IOException).
La clé de Registre est en lecture seule (UnauthorizedAccessException).
Sécurité
Pour exécuter ce processus, votre assembly requiert un niveau de privilège accordé par la classe RegistryPermission. Si vous exécutez le programme dans un contexte partiellement fiable, le processus peut lever une exception en raison de privilèges insuffisants. De même, l'utilisateur doit posséder les listes de contrôles d'accès appropriées pour pouvoir créer des paramètres ou écrire dans ceux-ci. Par exemple, une application locale disposant d'une autorisation de sécurité d'accès du code peut ne pas avoir une autorisation du système d'exploitation. Pour plus d'informations, consultez Notions fondamentales de la sécurité d'accès du code.
Voir aussi
Tâches
Comment : lire une valeur à partir d'une clé de Registre dans Visual Basic
Procédure pas à pas : création d'une clé de Registre et modification de ses valeurs
Dépannage : manipulation du Registre
Concepts
Tâches courantes relatives au Registre