Udostępnij za pośrednictwem

RegistryProxy.SetValue Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic.MyServices
Zestaw:
Microsoft.VisualBasic.dll
Zestaw:
Microsoft.VisualBasic.Forms.dll

Zapisuje wartość w kluczu rejestru.

Przeciążenia

SetValue(String, String, Object)

Zapisuje wartość w kluczu rejestru.
SetValue(String, String, Object, RegistryValueKind)

Zapisuje wartość w kluczu rejestru.

SetValue(String, String, Object)

Zapisuje wartość w kluczu rejestru.

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)

Parametry

keyName
String

String. Nazwa klucza do zapisania. Wymagane.

valueName
String

String. Nazwa wartości do zapisania. Wymagane.

value
Object

Object. Wartość do zapisania. Wymagane.

Wyjątki

ArgumentNullException

value to Nothing.

ArgumentException

keyName nie rozpoczyna się od prawidłowego katalogu głównego rejestru.

-lub-

valueName jest dłuższa niż dozwolona maksymalna długość (255 znaków).

UnauthorizedAccessException

Element RegistryKey jest tylko do odczytu i dlatego nie można go zapisać. Na przykład jest to węzeł na poziomie głównym lub nie został otwarty z dostępem do zapisu.

SecurityException

Użytkownik nie ma uprawnień wymaganych do tworzenia ani modyfikowania kluczy rejestru.

Przykłady

W tym przykładzie ustawiono wartość FontColor na "czerwony" w kluczu HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Uwagi

Jeśli określony klucz lub wartość nie istnieje, zostanie utworzony.

Oto przykład zadania obejmującego metodę My.Computer.Registry.SetValue .

Działanie Zobacz
Ustawianie wartości w kluczu rejestru Instrukcje: tworzenie klucza rejestru i określanie jego wartości

Zobacz też

Dotyczy

SetValue(String, String, Object, RegistryValueKind)

Zapisuje wartość w kluczu rejestru.

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)

Parametry

keyName
String

String. Nazwa klucza do zapisania. Wymagane.

valueName
String

String. Nazwa wartości do zapisania. Wymagane.

value
Object

Object. Wartość do zapisania. Wymagane.

valueKind
RegistryValueKind

RegistryValueKind. Wymagane.

Wyjątki

ArgumentNullException

value to Nothing.

ArgumentException

keyName nie rozpoczyna się od prawidłowego katalogu głównego rejestru.

-lub-

keyName jest dłuższa niż dozwolona maksymalna długość (255 znaków).

-lub-

Typ danych nie jest zgodny z value typem danych rejestru określonym przez valueKindmetodę , dlatego nie można poprawnie przekonwertować danych.

UnauthorizedAccessException

Element RegistryKey jest tylko do odczytu i nie można go zapisać, na przykład jest to węzeł na poziomie głównym lub nie został otwarty z dostępem do zapisu.

SecurityException

Użytkownik nie ma uprawnień wymaganych do tworzenia ani modyfikowania kluczy rejestru.

Przykłady

W tym przykładzie ustawiono wartość FontColor na "czerwony" w kluczu HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

Uwagi

Jeśli określony klucz lub wartość nie istnieje, zostanie utworzony.

Oto przykład zadania obejmującego metodę My.Computer.Registry.SetValue .

Działanie Zobacz
Ustawianie wartości w kluczu rejestru Instrukcje: tworzenie klucza rejestru i określanie jego wartości

Zobacz też

Dotyczy