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 -> unitPublic 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 -> unitPublic 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 方法的工作範例。
| 收件者 | 請參閱 |
|---|---|
| 在登錄機碼中設定值 | 作法：建立登錄機碼並設定其值 |
