RegistryProxy.SetValue Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

Zapíše hodnotu do klíče registru.

Přetížení

SetValue(String, String, Object)	Zapíše hodnotu do klíče registru.
SetValue(String, String, Object, RegistryValueKind)	Zapíše hodnotu do klíče registru.

SetValue(String, String, Object)

Zapíše hodnotu do klíče registru.

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. Název klíče, do který se má zapsat. Povinná hodnota.

valueName

String

String. Název hodnoty, která se má zapsat. Povinná hodnota.

value

Object

Object. Hodnota, která se má zapsat. Povinná hodnota.

Výjimky

ArgumentNullException

value je Nothing.

ArgumentException

keyName nezačíná platným kořenovým adresářem registru.

-nebo-

valueName je delší než maximální povolená délka (255 znaků).

UnauthorizedAccessException

Objekt RegistryKey je jen pro čtení, a proto se do něj nedá zapisovat. Jedná se například o kořenový uzel nebo nebyl otevřen s přístupem pro zápis.

SecurityException

Uživatel nemá oprávnění požadovaná k vytvoření nebo úpravě klíčů registru.

Příklady

Tento příklad nastaví hodnotu FontColor v klíči HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesna "red" .

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

Poznámky

Pokud zadaný klíč nebo hodnota neexistuje, vytvoří se.

Tady je příklad úlohy zahrnující metodu My.Computer.Registry.SetValue .

Záměr	Seznamte se s
Nastavení hodnoty v klíči registru	Postupy: Vytvoření klíče registru a nastavení jeho hodnoty

Viz také

• RegistryValueKind
• SetValue
• Objekty (Visual Basic)
• Čtení z registru a zápis do něj pomocí oboru názvů My (Visual Basic)
• Zabezpečení a registr (Visual Basic)

SetValue(String, String, Object, RegistryValueKind)

Zapíše hodnotu do klíče registru.

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. Název klíče, do který se má zapsat. Povinná hodnota.

valueName

String

String. Název hodnoty, která se má zapsat. Povinná hodnota.

value

Object

Object. Hodnota, která se má zapsat. Povinná hodnota.

valueKind

RegistryValueKind

RegistryValueKind. Povinná hodnota.

Výjimky

ArgumentNullException

value je Nothing.

ArgumentException

keyName nezačíná platným kořenovým adresářem registru.

-nebo-

keyName je delší než maximální povolená délka (255 znaků).

-nebo-

Typ value neodpovídá datovému typu registru určenému parametrem valueKind, proto data nelze správně převést.

UnauthorizedAccessException

Objekt RegistryKey je jen pro čtení, a proto se do něj nedá zapisovat. Jedná se například o kořenový uzel nebo nebyl otevřen s přístupem pro zápis.

SecurityException

Uživatel nemá oprávnění požadovaná k vytvoření nebo úpravě klíčů registru.

Příklady

Tento příklad nastaví hodnotu FontColor v klíči HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesna "red" .

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

Poznámky

Pokud zadaný klíč nebo hodnota neexistuje, vytvoří se.

Tady je příklad úlohy zahrnující metodu My.Computer.Registry.SetValue .

Záměr	Seznamte se s
Nastavení hodnoty v klíči registru	Postupy: Vytvoření klíče registru a nastavení jeho hodnoty

Viz také

• RegistryValueKind
• SetValue
• Objekty (Visual Basic)
• Čtení z registru a zápis do něj pomocí oboru názvů My (Visual Basic)
• Zabezpečení a registr (Visual Basic)