My.Computer.Registry.SetValue-Methode
Aktualisiert: November 2007
Schreibt einen Wert in einen Registrierungsschlüssel.
' 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 _
)
Parameter
keyName
String. Name des Schlüssels, in den geschrieben werden soll. Erforderlich.valueName
String. Name des Werts, der geschrieben werden soll. Erforderlich.value
Object. Wert, der geschrieben werden soll. Erforderlich.valueKind
RegistryValueKind. Erforderlich.
Hinweise
Wenn der angegebene Schlüssel oder Wert nicht vorhanden ist, wird er erstellt.
Ausnahmen
Unter den folgenden Bedingungen kann eine Ausnahme ausgelöst werden:
Der Name des Schlüssels lautet Nothing (ArgumentNullException).
Der Name des Schlüssels ist länger als 255 Zeichen (ArgumentException).
Der angegebene Hive ist nicht gültig (ArgumentException).
Der Schlüssel ist geschlossen (IOException).
Der Pfad ist nicht gültig (IOException).
Der Registrierungsschlüssel ist schreibgeschützt (UnauthorizedAccessException).
Aufgaben
Es folgt ein Beispiel für eine Aufgabe, in der die My.Computer.Registry.SetValue-Methode verwendet wird.
Ziel |
Weitere Informationen finden Sie unter |
---|---|
Festlegen eines Werts in einem Registrierungsschlüssel |
Gewusst wie: Erstellen eines Registrierungsschlüssels und Festlegen seiner Werte in Visual Basic |
Beispiel
In diesem Beispiel wird der Wert FontColor im HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences-Schlüssel auf "red" festgelegt.
My.Computer.Registry.LocalMachine.OpenSubKey _
("Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
Anforderungen
Namespace:Microsoft.VisualBasic.MyServices
Klasse:RegistryProxy (ermöglicht Zugriff auf Registry)
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Berechtigungen
Die folgende Berechtigung ist möglicherweise erforderlich:
Berechtigung |
Beschreibung |
---|---|
Steuert die Fähigkeit, auf die Registrierung zuzugreifen. Zugeordnete Enumerationen: RegistryPermissionAccess.Write, RegistryPermissionAccess.Create. |
Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.
Siehe auch
Aufgaben
Problembehandlung: Bearbeiten der Registrierung
Konzepte
Allgemeine Registrierungsaufgaben
Sicherheit und die Registrierung
Lesen aus der und Schreiben in die Registrierung mit My
Registrierungszugriff für Visual Basic 6.0-Benutzer