My.Computer.Registry.SetValue, méthode
Mise à jour : novembre 2007
Écrit une valeur dans une clé de Registre.
' Usage
My.Computer.Registry.SetValue(keyName ,valueName ,value)
My.Computer.Registry.SetValue(keyName ,valueName ,value ,valueKind)
' Declaration
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object _
)
' -or-
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object, _
ByVal valueKind As Microsoft.Win32.RegistryValueKind _
)
Paramètres
keyName
String. Nom de la clé dans laquelle écrire. Requis.valueName
String. Nom de la valeur à écrire. Requis.value
Object. Valeur à écrire. Requis.valueKind
RegistryValueKind. Requis.
Notes
Si la clé ou la valeur spécifiée n'existe pas, elle est créée.
Exceptions
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).
Tâches
Le tableau suivant affiche un exemple d'une tâche impliquant la méthode My.Computer.Registry.SetValue.
Pour |
Consultez |
|---|---|
Définir une valeur dans une clé de Registre |
Comment : créer une clé de Registre et définir ses valeurs dans Visual Basic |
Exemple
Cet exemple affecte "rouge" à la valeur FontColor dans la clé HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.
My.Computer.Registry.LocalMachine.OpenSubKey _
("Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
Configuration requise
Espace de noms :Microsoft.VisualBasic.MyServices
Classe :RegistryProxy (fournit l'accès à Registry)
Assembly : bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Autorisations
L'autorisation suivante peut être nécessaire :
Autorisation |
Description |
|---|---|
Contrôle la capacité à accéder au Registre. Énumérations associées : RegistryPermissionAccess.Write, RegistryPermissionAccess.Create. |
Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.
Voir aussi
Tâches
Dépannage : manipulation du Registre
Concepts
Tâches courantes relatives au Registre
Lecture et écriture dans le Registre à l'aide de My
Accès au Registre pour les utilisateurs de Visual Basic 6.0