C# 登錄表操作核心 API 詳解：Registry/RegistryKey 方法、資料型別、權限、遠端與最佳實務

前言：.NET 登錄表操作的兩大核心類別

Microsoft.Win32.Registry 提供七大根鍵靜態屬性；RegistryKey 封裝鍵值的開啟、建立、讀寫、刪除、權限控制。兩者皆為 sealed 密封類別。本文系統整理所有公用方法簽章、參數細節、回傳值語意、異常情況、資料型別對應、32/64 位元視圖、遠端操作、存取控制清單 (ACL) 進階用法。

一、Registry 靜態根鍵屬性

public static RegistryKey ClassesRoot { get; }      // HKEY_CLASSES_ROOT
public static RegistryKey CurrentUser { get; }      // HKEY_CURRENT_USER
public static RegistryKey LocalMachine { get; }     // HKEY_LOCAL_MACHINE
public static RegistryKey Users { get; }            // HKEY_USERS
public static RegistryKey CurrentConfig { get; }    // HKEY_CURRENT_CONFIG
public static RegistryKey DynData { get; }          // HKEY_DYN_DATA (已棄用)
public static RegistryKey PerformanceData { get; }  // HKEY_PERFORMANCE_DATA (唯讀)

• 屬性回傳 RegistryKey 實例，代表對應根鍵的開啟控制代碼。
• 根鍵實例**不需**也**不可**呼叫 Close()/Dispose()（由框架管理）。

二、RegistryKey 核心方法完整簽章

2.1 開啟/建立子鍵

2.2 遠端基底鍵

public static RegistryKey OpenRemoteBaseKey(RegistryHive hKey, string machineName)
public static RegistryKey OpenRemoteBaseKey(RegistryHive hKey, string machineName, RegistryView view)

• RegistryHive 列舉：ClassesRoot、CurrentUser、LocalMachine、Users、CurrentConfig、PerformanceData。
• 遠端機器需啟用「遠端登錄」服務、防火牆開放 RPC (TCP 135/445)、呼叫者具備遠端存取權限。
• CurrentUser 無遠端對應（屬於互動會話）。

2.3 刪除子鍵

2.4 讀取值

2.5 寫入值

2.6 刪除值

public void DeleteValue(string name)
public void DeleteValue(string name, bool throwOnMissingValue)

2.7 關閉與釋放

public void Close()      // 釋放非受控 HKEY
public void Dispose()    // 介面 IDisposable 實作，同 Close
public void Flush()      // 強制將快取寫入磁碟（通常不需手動呼叫）

• 建議使用 using 區塊 確保釋放：using (var key = Registry.CurrentUser.OpenSubKey(...)) { }

2.8 存取控制（.NET 4.6+）

public RegistrySecurity GetAccessControl()
public RegistrySecurity GetAccessControl(AccessControlSections includeSections)
public void SetAccessControl(RegistrySecurity registrySecurity)

// 範例：授予「Users」群組讀寫權限
var security = new RegistrySecurity();
security.AddAccessRule(new RegistryAccessRule(
    "Users", RegistryRights.ReadKey | RegistryRights.WriteKey, AccessControlType.Allow));
using (var key = Registry.CurrentUser.CreateSubKey(@"Software\MyApp", 
    RegistryKeyPermissionCheck.ReadWriteSubTree, security)) { ... }

三、RegistryValueKind 資料型別完整對應

四、常見異常與處理策略

五、32/64 位元視圖重導向（RegistryView）

// 開啟 64 位元視圖的 HKLM\Software
using (var key = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64)
                 .OpenSubKey(@"Software\MyApp")) { ... }

// 開啟 32 位元視圖的 HKLM\Software (WoW6432Node)
using (var key = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32)
                 .OpenSubKey(@"Software\MyApp")) { ... }

• 64 位元進程預設 RegistryView.Default = Registry64。
• 32 位元進程 (WoW64) 預設 RegistryView.Default = Registry32。
• 安裝程式若為 32 位元，寫入 HKLM\Software 實際進入 Wow6432Node；64 位元讀取時需明確指定 RegistryView.Registry32。

六、最佳實務總結

1. 永遠使用 using / try/finally 管理 RegistryKey 生命週期，避免控制代碼洩漏。
2. 讀取前檢查 null：OpenSubKey/GetValue 可能回傳 null。
3. 寫入數值/二進位/多字串時明確指定 RegistryValueKind，避免自動推斷錯誤（如長整數被存為 String）。
4. 跨架構部署（32/64 位元）必須指定 RegistryView，否則讀寫位置不一致。
5. 敏感資料使用 DPAPI (ProtectedData) 加密後再寫入，登錄表非加密存儲。
6. 避免高頻讀寫：啟動時快取至記憶體，運行期操作快取，關機/變更時同步回寫。
7. 單元測試採用介面抽象：IRegistry + MockRegistry，避免污染真實登錄表。
8. 現代 .NET 應用優先使用 appsettings.json + IConfiguration，登錄表保留給系統整合、安裝資訊、檔案關聯、原則設定。

七、快速參考：常用操作單行程式碼

// 讀取字串值（不存在回傳預設值）
string path = Registry.GetValue(@"HKEY_CURRENT_USER\Software\MyApp", "Path", @"C:\Default") as string;

// 寫入 DWORD 值
Registry.SetValue(@"HKEY_CURRENT_USER\Software\MyApp", "Version", 2, RegistryValueKind.DWord);

// 刪除值
Registry.CurrentUser.OpenSubKey(@"Software\MyApp", true)?.DeleteValue("Obsolete", false);

// 檢查鍵是否存在
bool exists = Registry.CurrentUser.OpenSubKey(@"Software\MyApp") != null;

// 列舉所有子鍵名稱
string[] subKeys = Registry.CurrentUser.OpenSubKey(@"Software\MyApp")?.GetSubKeyNames() ?? Array.Empty();

結語

Registry 與 RegistryKey 提供了完整、型別安全、物件導向的登錄表操作 API。掌握根鍵存取、子鍵 CRUD、資料型別對應、RegistryView 跨架構視圖、遠端操作、ACL 權限控制、異常處理與最佳實務，即能在 Windows 平台上安全、高效、可維護地管理應用程式與系統設定。隨著 .NET 跨平台演進，登錄表操作逐漸成為 Windows 專有功能，新專案應優先採用跨平台設定系統（IConfiguration、appsettings.json、環境變數、雲端設定中心）。