RegistryProxy.SetValue Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
value
je Nothing
.
keyName
nezačíná platným kořenovým adresářem registru.
-nebo-
valueName
je delší než maximální povolená délka (255 znaků).
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.
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\Preferences
na "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)
Platí pro
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
value
je Nothing
.
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.
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.
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\Preferences
na "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)