C# RegistryKey类：注册表增删改查操作指南

RegistryKey基础概述

RegistryKey是.NET Framework中用于表示Windows注册表内项级节点的类。注册表是一个层次化的数据库，其中包含操作系统和应用程序的配置信息。每个注册表项类似于文件资源管理器中的文件夹，可以包含子项（SubKeys）和值（Values）。操作注册表需要谨慎，错误的修改可能导致系统不稳定或应用程序崩溃。

获取注册表根项

所有操作都始于获取一个RegistryKey实例。通常使用System.Windows.Registry静态类提供的公共只读字段作为起点，例如HKEY_CURRENT_USER (CurrentUser) 或 HKEY_LOCAL_MACHINE (LocalMachine)。

using Microsoft.Win32;

// 获取当前用户配置根节点
RegistryKey currentUserKey = Registry.CurrentUser;

主要操作方法详解

第1步：创建或打开子项

若需向特定路径写入数据或添加新的配置键，可使用CreateSubKey方法。该方法会尝试打开指定的子项；如果子项不存在，则自动创建它，并返回该RegistryKey对象供后续操作使用。

// 在HKEY_CURRENT_USER\Software下创建或打开名为"MyApp"的子项
// true表示具有写入权限
string subKeyName = "Software\\MyApp";
RegistryKey appKey = Registry.CurrentUser.CreateSubKey(subKeyName, RegistryKeyPermissionCheck.ReadWriteSubTree);

第2步：设置和更新值

一旦获得子项的引用，即可使用SetValue方法添加或修改对应的键值对。该方法支持多种数据类型，常见的包括字符串(String)、双字(DWORD)和二进制(Binary)。为了数据准确性，建议显式指定RegistryValueKind枚举类型。

// 设置字符串类型的配置值
appKey.SetValue("AppName", "MyTestApplication", RegistryValueKind.String);

// 设置DWORD类型的配置值
appKey.SetValue("InstallCount", 1, RegistryValueKind.DWord);

// 注意：在C#中必须手动调用Flush()或Close()将更改保存回注册表
appKey.Flush();
appKey.Close();

第3步：读取注册表值

查询操作相对简单，只需调用GetValue方法。由于某些注册表项可能不包含指定名称的值，因此最好提供一个默认值，以避免抛出NullReferenceException或IndexOutOfRangeException异常。同时，OpenSubKey常用于只读访问场景以提高性能。

// 以只读方式打开子项
RegistryKey readOnlyKey = Registry.CurrentUser.OpenSubKey("Software\\MyApp", false);
if (readOnlyKey != null)
{
    // 获取字符串值，如果不存在则返回默认值"Unknown"
    string appName = readOnlyKey.GetValue("AppName") as string ?? "DefaultName";
    Console.WriteLine($"当前应用名称: {appName}");
    
    readOnlyKey.Close();
}

第4步：删除子项或值

清理无用配置时，可使用DeleteValue移除单个键值对，或使用DeleteSubKey删除整个子项树。在执行删除前务必验证其存在性，以免引发错误。

// 删除名为"TempData"的键值对
appKey.DeleteValue("TempData");

// 删除名为"OldVersion"的子项及其所有内容
appKey.DeleteSubKeyTree("OldVersion", false); // false表示找不到子项时不抛异常

注意事项与最佳实践

1. 权限控制：涉及HKEY_LOCAL_MACHINE的操作通常需要管理员权限。建议在代码中添加逻辑判断或在安装阶段提示用户提权。
2. 内存与资源释放：RegistryKey实现了IDisposable接口。在使用完毕后应显式调用Close()方法或者使用using语句块包裹实例，以确保底层句柄被正确释放，防止内存泄漏。
3. 安全性：不要在注册表中存储敏感数据（如密码），因为即使加密，普通用户也可能通过技术手段提取出密钥信息。
4. 版本差异：在较新的 .NET Core/.NET 5+ 中，System.Windows.Registry已迁移至Microsoft.Extensions.Configuration.SystemConfiguration包，使用前需确认项目依赖环境。