RegistryProxy.SetValue 方法

  • 参考

定义

命名空间:
Microsoft.VisualBasic.MyServices
程序集:
Microsoft.VisualBasic.dll
程序集:
Microsoft.VisualBasic.Forms.dll

向注册表项中写入值。

重载

SetValue(String, String, Object)

向注册表项中写入值。
SetValue(String, String, Object, RegistryValueKind)

向注册表项中写入值。

SetValue(String, String, Object)

向注册表项中写入值。

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)

参数

keyName
String

String. 要写入到的项的名称。 必需。

valueName
String

String. 要写入的值的名称。 必需。

value
Object

Object. 要写入的值。 必需。

例外

ArgumentNullException

value 为 Nothing。

ArgumentException

keyName 未以有效注册表根开头。

- 或 -

valueName 的长度超过了允许的最大长度（255 个字符）。

UnauthorizedAccessException

RegistryKey 是只读的，因此无法对其写入内容（例如，它是根级节点，或者未用写访问权限打开该项）。

SecurityException

用户没有创建或修改注册表项所需的权限。

示例

本示例将键 HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences中的值FontColor设置为“red”。

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

注解

如果指定的键或值不存在，则会创建它。

下面是涉及 My.Computer.Registry.SetValue 方法的任务示例。

功能 查看
在注册表项中设置值 如何：创建注册表项并设置其值

另请参阅

适用于

SetValue(String, String, Object, RegistryValueKind)

向注册表项中写入值。

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)

参数

keyName
String

String. 要写入到的项的名称。 必需。

valueName
String

String. 要写入的值的名称。 必需。

value
Object

Object. 要写入的值。 必需。

valueKind
RegistryValueKind

RegistryValueKind. 必需。

例外

ArgumentNullException

value 为 Nothing。

ArgumentException

keyName 未以有效注册表根开头。

- 或 -

keyName 的长度超过了允许的最大长度（255 个字符）。

- 或 -

value 的类型与 valueKind 指定的注册表数据类型不匹配，因此，无法正确转换该数据。

UnauthorizedAccessException

RegistryKey 是只读的，因此无法对其写入（例如，它是根级节点，或者未用写访问权限打开该项）。

SecurityException

用户没有创建或修改注册表项所需的权限。

示例

本示例将键 HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences中的值FontColor设置为“red”。

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

注解

如果指定的键或值不存在，则会创建它。

下面是涉及 My.Computer.Registry.SetValue 方法的任务示例。

功能 查看
在注册表项中设置值 如何：创建注册表项并设置其值

另请参阅

适用于