RegistryProxy.SetValue 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向注册表项中写入值。
重载
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
. 要写入的值。 必需。
例外
value
为 Nothing
。
RegistryKey 是只读的,因此无法对其写入内容(例如,它是根级节点,或者未用写访问权限打开该项)。
用户没有创建或修改注册表项所需的权限。
示例
本示例将键 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. 必需。
例外
value
为 Nothing
。
keyName
未以有效注册表根开头。
- 或 -
keyName
的长度超过了允许的最大长度(255 个字符)。
- 或 -
value
的类型与 valueKind
指定的注册表数据类型不匹配,因此,无法正确转换该数据。
RegistryKey 是只读的,因此无法对其写入(例如,它是根级节点,或者未用写访问权限打开该项)。
用户没有创建或修改注册表项所需的权限。
示例
本示例将键 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
方法的任务示例。
功能 | 查看 |
---|---|
在注册表项中设置值 | 如何:创建注册表项并设置其值 |