C#如何操作注册表 C# Registry类读写Windows注册表项

在C#中操作Windows注册表主要依赖Microsoft.Win32命名空间下的Registry和RegistryKey类，这两个类提供了完整的注册表操作能力，不需要额外引入第三方库，就能完成对注册表各项内容的增删改查操作。

C#操作注册表的基础准备

首先需要引入对应的命名空间，Registry类提供了访问注册表根项的静态属性，常见的根项包括HKEY_CURRENT_USER、HKEY_LOCAL_MACHINE等，不同的根项对应不同的作用范围，操作前需要根据需求选择合适的根项。

操作注册表需要程序具备对应的权限，如果是修改HKEY_LOCAL_MACHINE下的项，通常需要以管理员身份运行程序，否则会抛出权限不足的异常。如果只需要操作当前用户的注册表项，使用HKEY_CURRENT_USER根项即可，普通权限就能完成操作。

读取注册表项的操作

读取注册表项需要先打开对应的注册表项，然后获取指定名称的值，操作完成后需要释放RegistryKey对象避免资源泄漏。以下是读取HKEY_CURRENT_USER下SoftwareTestApp路径中Name键值的示例代码：

using Microsoft.Win32;
using System;

class RegistryReadDemo
{
    static void Main()
    {
        // 打开HKEY_CURRENT_USER下的SoftwareTestApp子项
        RegistryKey testKey = Registry.CurrentUser.OpenSubKey(@"SoftwareTestApp", false);
        if (testKey != null)
        {
            // 读取名为Name的键值，默认值为空字符串
            object nameValue = testKey.GetValue("Name", "");
            Console.WriteLine($"读取到的Name值：{nameValue}");
            // 关闭注册表项释放资源
            testKey.Close();
        }
        else
        {
            Console.WriteLine("指定的注册表项不存在");
        }
    }
}

写入注册表项的操作

写入注册表项需要以可写权限打开对应的注册表项，如果目标项不存在，可以通过CreateSubKey方法自动创建。写入时支持多种数据类型，包括字符串、整数、字节数组等，以下是创建并写入注册表项的示例：

using Microsoft.Win32;
using System;

class RegistryWriteDemo
{
    static void Main()
    {
        try
        {
            // 创建或打开HKEY_CURRENT_USER下的SoftwareTestApp子项，设置为可写
            RegistryKey testKey = Registry.CurrentUser.CreateSubKey(@"SoftwareTestApp", true);
            if (testKey != null)
            {
                // 写入字符串类型的键值
                testKey.SetValue("Name", "TestApplication", RegistryValueKind.String);
                // 写入整数类型的键值
                testKey.SetValue("Version", 1001, RegistryValueKind.DWord);
                Console.WriteLine("注册表项写入成功");
                testKey.Close();
            }
        }
        catch (UnauthorizedAccessException ex)
        {
            Console.WriteLine($"权限不足，无法写入注册表：{ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"写入注册表时发生错误：{ex.Message}");
        }
    }
}

删除注册表项的操作

删除注册表项时需要注意，如果项下面还有子项，直接使用DeleteSubKey会抛出异常，需要先删除子项再删除父项，或者使用DeleteSubKeyTree方法递归删除所有子项。以下是删除注册表项的示例：

using Microsoft.Win32;
using System;

class RegistryDeleteDemo
{
    static void Main()
    {
        try
        {
            // 删除HKEY_CURRENT_USER下的SoftwareTestApp项及其所有子项
            Registry.CurrentUser.DeleteSubKeyTree(@"SoftwareTestApp", false);
            Console.WriteLine("注册表项删除成功");
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine($"要删除的注册表项不存在：{ex.Message}");
        }
        catch (UnauthorizedAccessException ex)
        {
            Console.WriteLine($"权限不足，无法删除注册表项：{ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"删除注册表项时发生错误：{ex.Message}");
        }
    }
}

操作注册表的注意事项

• 操作注册表时一定要做好异常处理，尤其是权限不足、项不存在等常见异常，避免程序崩溃。
• RegistryKey对象使用完毕后要及时调用Close方法释放资源，或者使用using语句自动释放。
• 不要随意修改系统关键的注册表项，尤其是HKEY_LOCAL_MACHINE下的系统相关项，错误的修改可能导致系统异常。
• 如果程序需要操作HKEY_LOCAL_MACHINE下的项，建议在程序清单中设置管理员权限启动，避免运行时权限不足。

常用Registry类属性说明

Registry类的静态属性对应不同的注册表根项，以下是常用属性的说明：

C#RegistryWindows注册表注册表读写修改时间：2026-07-09 18:00:34