RegistryProxy.SetValue 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將值寫入登錄檔鍵。
多載
| 名稱 | Description |
|---|---|
| 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 節點為唯讀，因此無法寫入;例如，它是根節點，或尚未開啟寫入權限。
使用者沒有建立或修改登錄表金鑰所需的權限。
範例
此範例將值 FontColor 設定為「紅色」，鍵值為 HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences。
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 節點為唯讀，因此無法寫入;例如，它是根節點，或尚未以寫入權限開啟。
使用者沒有建立或修改登錄表金鑰所需的權限。
範例
此範例將值 FontColor 設定為「紅色」，鍵值為 HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences。
My.Computer.Registry.LocalMachine.OpenSubKey(
"Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
備註
若指定的鍵或值不存在，則會建立該鍵。
這裡有一個涉及此 My.Computer.Registry.SetValue 方法的任務範例。
| 至 | 看！ |
|---|---|
| 在登錄檔鍵中設定一個值 | 如何：建立登錄檔金鑰並設定其值 |