Share via

RegistryProxy.SetValue Méthode

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Écrit une valeur dans une clé de Registre.

Surcharges

SetValue(String, String, Object)

Écrit une valeur dans une clé de Registre.
SetValue(String, String, Object, RegistryValueKind)

Écrit une valeur dans une clé de Registre.

SetValue(String, String, Object)

Écrit une valeur dans une clé de Registre.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value);
public void SetValue (string keyName, string valueName, object value);
member this.SetValue : string * string * obj -> unit
Public Sub SetValue (keyName As String, valueName As String, value As Object)

Paramètres

keyName
String

String. Nom de la clé dans laquelle écrire. Obligatoire.

valueName
String

String. Nom de la valeur à écrire. Obligatoire.

value
Object

Object. Valeur à écrire. Obligatoire.

Exceptions

ArgumentNullException

value a la valeur Nothing.

ArgumentException

keyName ne commence pas par une racine de Registre valide.

- ou -

La longueur de valueName est supérieure à la longueur maximale autorisée (255 caractères).

UnauthorizedAccessException

RegistryKey étant en lecture seule, il n’est pas accessible en écriture ; il s’agit par exemple d’un nœud de niveau racine ou il n’a pas été ouvert avec un accès en écriture.

SecurityException

L'utilisateur n'a pas les autorisations requises pour créer ou modifier des clés de Registre.

Exemples

Cet exemple montre comment définir la valeur FontColor « red » 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")

Remarques

Si la clé ou la valeur spécifiée n’existe pas, elle est créée.

Voici un exemple de tâche impliquant la My.Computer.Registry.SetValue méthode .

À Consultez
Définir une valeur dans une clé de Registre Procédure : créer une clé de Registre et définir sa valeur

Voir aussi

S’applique à

SetValue(String, String, Object, RegistryValueKind)

Écrit une valeur dans une clé de Registre.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value, Microsoft::Win32::RegistryValueKind valueKind);
public void SetValue (string keyName, string valueName, object value, Microsoft.Win32.RegistryValueKind valueKind);
member this.SetValue : string * string * obj * Microsoft.Win32.RegistryValueKind -> unit
Public Sub SetValue (keyName As String, valueName As String, value As Object, valueKind As RegistryValueKind)

Paramètres

keyName
String

String. Nom de la clé dans laquelle écrire. Obligatoire.

valueName
String

String. Nom de la valeur à écrire. Obligatoire.

value
Object

Object. Valeur à écrire. Obligatoire.

valueKind
RegistryValueKind

RegistryValueKind. Obligatoire.

Exceptions

ArgumentNullException

value a la valeur Nothing.

ArgumentException

keyName ne commence pas par une racine de Registre valide.

- ou -

La longueur de keyName est supérieure à la longueur maximale autorisée (255 caractères).

- ou -

Le type de value ne correspond pas au type de données de Registre spécifié par valueKind, par conséquent les données ne peuvent pas être converties correctement.

UnauthorizedAccessException

RegistryKey étant en lecture seule, il n'est pas accessible en écriture ; il s'agit par exemple d'un nœud de niveau racine ou il n'a pas été ouvert avec un accès en écriture.

SecurityException

L'utilisateur n'a pas les autorisations requises pour créer ou modifier des clés de Registre.

Exemples

Cet exemple montre comment définir la valeur FontColor « red » 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")

Remarques

Si la clé ou la valeur spécifiée n’existe pas, elle est créée.

Voici un exemple de tâche impliquant la My.Computer.Registry.SetValue méthode .

À Consultez
Définir une valeur dans une clé de Registre Procédure : créer une clé de Registre et définir sa valeur

Voir aussi

S’applique à