RegistryProxy.SetValue Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.MyServices

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ż

• RegistryValueKind
• SetValue
• Obiekty (Visual Basic)
• Odczytywanie z oraz zapisywanie do rejestru (Visual Basic)
• Bezpieczeństwo i rejestr (Visual Basic)

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ż

• RegistryValueKind
• SetValue
• Obiekty (Visual Basic)
• Odczytywanie z oraz zapisywanie do rejestru (Visual Basic)
• Bezpieczeństwo i rejestr (Visual Basic)