RegistryProxy.SetValue Methode

Definition

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt einen Wert in einen Registrierungsschlüssel.

Überlädt

Name	Beschreibung
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. Der Name des zu schreibenden Schlüssels. Required.

valueName: String

String. Name des zu schreibenden Werts. Required.

value: Object

Object. Wert, der geschrieben werden soll. Required.

Ausnahmen

ArgumentNullException

value ist Nothing.

ArgumentException

keyName beginnt nicht mit einem gültigen Registrierungsstamm.

-oder-

valueName ist länger als die maximal zulässige Länge (255 Zeichen).

UnauthorizedAccessException

Dies RegistryKey ist schreibgeschützt und kann daher nicht geschrieben werden, z. B. ein Knoten auf Stammebene oder es wurde nicht mit Schreibzugriff geöffnet.

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 auf "rot" im Schlüssel HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesfestgelegt.

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 ist ein Beispiel für eine Aufgabe, die die My.Computer.Registry.SetValue Methode umfasst.

To	Siehe
Festlegen eines Werts in einem Registrierungsschlüssel	Vorgehensweise: Erstellen eines Registrierungsschlüssels und Festlegen des zugehörigen Werts

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. Der Name des zu schreibenden Schlüssels. Required.

valueName: String

String. Name des zu schreibenden Werts. Required.

value: Object

Object. Wert, der geschrieben werden soll. Required.

valueKind: RegistryValueKind

RegistryValueKind. Required.

Ausnahmen

ArgumentNullException

value ist Nothing.

ArgumentException

keyName beginnt nicht mit einem gültigen Registrierungsstamm.

-oder-

keyName ist länger als die maximal zulässige Länge (255 Zeichen).

-oder-

Der Typ von value stimmt nicht mit dem registrierungsdatentyp überein, der durch valueKindangegeben wird, daher können die Daten nicht ordnungsgemäß konvertiert werden.

UnauthorizedAccessException

Dies RegistryKey ist schreibgeschützt und kann daher nicht geschrieben werden, z. B. ein Knoten auf Stammebene oder es wurde nicht mit Schreibzugriff geöffnet.

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 auf "rot" im Schlüssel HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesfestgelegt.

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 ist ein Beispiel für eine Aufgabe, die die My.Computer.Registry.SetValue Methode umfasst.

To	Siehe
Festlegen eines Werts in einem Registrierungsschlüssel	Vorgehensweise: Erstellen eines Registrierungsschlüssels und Festlegen des zugehörigen Werts

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?