RegistryProxy.SetValue Methode

Definition

Namespace:

Microsoft.VisualBasic.MyServices

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

• RegistryValueKind
• SetValue
• Objekte (Visual Basic)
• Lesen aus der und Schreiben in die Registrierung (Visual Basic)
• Sicherheit und die Registrierung (Visual Basic)

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

• RegistryValueKind
• SetValue
• Objekte (Visual Basic)
• Lesen aus der und Schreiben in die Registrierung (Visual Basic)
• Sicherheit und die Registrierung (Visual Basic)