Share via

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 方法的工作範例。

收件者 請參閱
在登錄機碼中設定值 作法：建立登錄機碼並設定其值

另請參閱

適用於