My.Computer.Registry.SetValue 方法
更新：2007 年 11 月
將值寫入登錄機碼 (Registry Key)。
' Usage
My.Computer.Registry.SetValue(keyName ,valueName ,value)
My.Computer.Registry.SetValue(keyName ,valueName ,value ,valueKind)
' Declaration
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object _
)
' -or-
Public Sub SetValue( _
ByVal keyName As String, _
ByVal valueName As String, _
ByVal value As Object, _
ByVal valueKind As Microsoft.Win32.RegistryValueKind _
)
參數
keyName
String。要寫入的機碼名稱。必要項。valueName
String。要寫入的值名稱。必要項。value
Object。要寫入的值。必要項。valueKind
RegistryValueKind。必要項。
備註
如果指定的機碼或值不存在，則會建立它。
例外狀況
下列情形可能會造成例外狀況 (Exception)：
機碼的名稱為 Nothing (ArgumentNullException)。
機碼名稱超過 255 個字元的限制 (ArgumentException)。
指定的登錄區無效 (ArgumentException)。
機碼已關閉 (IOException)。
路徑無效 (IOException)。
唯讀的登錄機碼 (UnauthorizedAccessException)。
工作
下列範例會示範涉及 My.Computer.Registry.SetValue 方法的工作。
若要 |
請參閱 |
|---|---|
設定登錄機碼中的值 |
範例
這個範例會將機碼 HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences 中的值 FontColor 設定為 "red"。
My.Computer.Registry.LocalMachine.OpenSubKey _
("Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")
需求
命名空間︰Microsoft.VisualBasic.MyServices
類別 (Class)：RegistryProxy (提供對 Registry 的存取)
組件：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)
使用權限
下列使用權限可能為必要：
使用權限 |
描述 |
|---|---|
控制存取登錄的能力。關聯的列舉型別：RegistryPermissionAccess.Write 和 RegistryPermissionAccess.Create。 |