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.

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 :

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

Sécurité et Registre

Lecture et écriture dans le Registre à l'aide de My

Accès au Registre pour les utilisateurs de Visual Basic 6.0

Référence

My.Computer.Registry, objet

Microsoft.Win32.RegistryValueKind

Registry.SetValue