Freigeben über

RegistryProxy.SetValue Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Schreibt einen Wert in einen Registrierungsschlüssel.

Überlädt

SetValue(String, String, Object)

Schreibt einen Wert in einen Registrierungsschlüssel.
SetValue(String, String, Object, RegistryValueKind)

Schreibt einen Wert in einen Registrierungsschlüssel.

SetValue(String, String, Object)

Schreibt einen Wert in einen Registrierungsschlüssel.

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)

Parameter

keyName
String

String. Name des Schlüssels, in den geschrieben werden soll. Erforderlich.

valueName
String

String. Name des zu schreibenden Werts. Erforderlich.

value
Object

Object. Zu schreibender Wert. Erforderlich.

Ausnahmen

ArgumentNullException

value ist Nothing.

ArgumentException

keyName beginnt nicht mit einem gültigen Registrierungsstamm.

- oder -

valueName überschreitet die maximal zulässige Länge (255 Zeichen).

UnauthorizedAccessException

RegistryKey ist schreibgeschützt. Es ist kein Schreibzugriff möglich, d. h. es handelt sich z. B. um einen Knoten auf Stammebene, oder das Öffnen erfolgte ohne Schreibzugriff.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Erstellen oder Ändern von Registrierungsschlüsseln.

Beispiele

In diesem Beispiel wird der Wert FontColor im Schlüssel HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesauf "rot" festgelegt.

My.Computer.Registry.LocalMachine.OpenSubKey(
  "Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")

Hinweise

Wenn der angegebene Schlüssel oder Wert nicht vorhanden ist, wird er erstellt.

Hier sehen Sie ein Beispiel für eine Aufgabe, die die My.Computer.Registry.SetValue -Methode umfasst.

Beschreibung Siehe
Festlegen eines Werts in einem Registrierungsschlüssel Vorgehensweise: Erstellen von Registrierungsschlüsseln und Festlegen ihrer Werte

Weitere Informationen

Gilt für:

SetValue(String, String, Object, RegistryValueKind)

Schreibt einen Wert in einen Registrierungsschlüssel.

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)

Parameter

keyName
String

String. Name des Schlüssels, in den geschrieben werden soll. Erforderlich.

valueName
String

String. Name des zu schreibenden Werts. Erforderlich.

value
Object

Object. Zu schreibender Wert. Erforderlich.

valueKind
RegistryValueKind

RegistryValueKind. Erforderlich.

Ausnahmen

ArgumentNullException

value ist Nothing.

ArgumentException

keyName beginnt nicht mit einem gültigen Registrierungsstamm.

- oder -

keyName überschreitet die maximal zulässige Länge (255 Zeichen).

- oder -

Der Typ von value stimmt nicht mit dem durch valueKind angegebenen Registrierungsdatentyp überein. Die Daten können daher nicht ordnungsgemäß konvertiert werden.

UnauthorizedAccessException

Der RegistryKey ist schreibgeschützt. Es ist kein Schreibzugriff möglich, d. h. es handelt sich z. B. um einen Knoten auf Stammebene, oder das Öffnen erfolgte ohne Schreibzugriff.

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Erstellen oder Ändern von Registrierungsschlüsseln.

Beispiele

In diesem Beispiel wird der Wert FontColor im Schlüssel HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesauf "rot" festgelegt.

My.Computer.Registry.LocalMachine.OpenSubKey(
  "Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")

Hinweise

Wenn der angegebene Schlüssel oder Wert nicht vorhanden ist, wird er erstellt.

Hier sehen Sie ein Beispiel für eine Aufgabe, die die My.Computer.Registry.SetValue -Methode umfasst.

Beschreibung Siehe
Festlegen eines Werts in einem Registrierungsschlüssel Vorgehensweise: Erstellen von Registrierungsschlüsseln und Festlegen ihrer Werte

Weitere Informationen

Gilt für: