Microsoft.Win32.Registry

提供表示 Windows 注册表中的根项的 对象，并提供访问项/值对的 static 方法。

定义文档的类型（或类）以及与那些类型关联的属性。该字段读取 Windows 注册表基项 HKEY_CLASSES_ROOT。

包含有关非用户特定的硬件的配置信息。该字段读取 Windows 注册表基项 HKEY_CURRENT_CONFIG。

包含有关当前用户首选项的信息。该字段读取 Windows 注册表基项 HKEY_CURRENT_USER

检索与指定的注册表项中的指定名称关联的值。如果在指定的项中未找到该名称，则返回您提供的默认值；或者，如果指定的项不存在，则返回 null。

如果由 指定的子项不存在，则返回 null；否则，返回与 关联的值；或者，如果未找到 ，则返回 。 以有效注册表根（如“HKEY_CURRENT_USER”）开头的键的完整注册表路径。 名称/值对的名称。 当 不存在时返回的值。 该用户没有读取注册表项所需的权限。 包含指定值的 已标记为删除。 未以有效注册表根开头。

包含本地计算机的配置数据。该字段读取 Windows 注册表基项 HKEY_LOCAL_MACHINE。

包含软件组件的性能信息。该字段读取 Windows 注册表基项 HKEY_PERFORMANCE_DATA。

设置指定的注册表项的指定名称/值对。如果指定的项不存在，则创建该项。

以有效注册表根（如“HKEY_CURRENT_USER”）开头的键的完整注册表路径。 名称/值对的名称。 要存储的值。 为 null。 未以有效注册表根开头。- 或 - 的长度超过了允许的最大长度（255 个字符）。 是只读的，因此无法对其写入；例如，它是根级节点。 用户没有创建或修改注册表项所需的权限。

通过使用指定的注册表数据类型，设置该指定的注册表项的名称/值对。如果指定的项不存在，则创建该项。

以有效注册表根（如“HKEY_CURRENT_USER”）开头的键的完整注册表路径。 名称/值对的名称。 要存储的值。 在存储数据时使用的注册表数据类型。 为 null。 未以有效注册表根开头。- 或 - 的长度超过了允许的最大长度（255 个字符）。- 或 - 的类型与 指定的注册表数据类型不匹配，因此，未能正确转换该数据。 是只读的，因此无法对其写入（例如，它是根级节点，或者未用写访问权限打开该项）。 用户没有创建或修改注册表项所需的权限。

包含有关默认用户配置的信息。该字段读取 Windows 注册表基项 HKEY_USERS。

表示外部计算机上的顶级节点的可能值。

表示另一个计算机上的 HKEY_CLASSES_ROOT 基项。此值可传递给 方法，以远程打开此节点。

表示另一个计算机上的 HKEY_CURRENT_CONFIG 基项。此值可传递给 方法，以远程打开此节点。

表示另一个计算机上的 HKEY_CURRENT_USER 基项。此值可传递给 方法，以远程打开此节点。

表示另一个计算机上的 HKEY_LOCAL_MACHINE 基项。此值可传递给 方法，以远程打开此节点。

表示另一个计算机上的 HKEY_PERFORMANCE_DATA 基项。此值可传递给 方法，以远程打开此节点。

表示另一个计算机上的 HKEY_USERS 基项。此值可传递给 方法，以远程打开此节点。

表示 Windows 注册表中的项级节点。此类是注册表封装。

创建一个新子项或打开一个现有子项以进行写访问。

新创建的子项，如果操作失败，则为 null。如果为 指定了零长度字符串，则返回当前的 对象。 要创建或打开的子项的名称或路径。此字符串不区分大小写。 为 null。 用户没有创建或打开该注册表项所需的权限。 调用此方法时所针对的 已关闭（无法访问已关闭的项）。 无法写入 ；例如，它不是作为可写入项打开的，或者用户没有必需的访问权限。 嵌套级别超过 510。- 或 -发生系统错误，例如，删除了项，或者尝试在 根中创建项。

创建一个新的子项或用指定的访问权限打开一个现有子项。从开始，提供.NET Framework 2015

新创建的子项，如果操作失败，则为 null。如果为 指定了零长度字符串，则返回当前的 对象。 要创建或打开的子项的名称或路径。此字符串不区分大小写。 true若要指示新的子项是可写 ；否则为false。 为 null。 用户没有创建或打开该注册表项所需的权限。 无法写入当前 ；例如，它未作为可写入项打开，或用户不具有必要的访问权限。 嵌套级别超过 510。- 或 -发生系统错误，例如，删除了项，或者尝试在 根中创建项。

创建一个新的子项或用指定的访问权限打开一个现有子项。从开始，提供.NET Framework 2015

新创建的子项，如果操作失败，则为 null。如果为 指定了零长度字符串，则返回当前的 对象。 要创建或打开的子项的名称或路径。此字符串不区分大小写。 true若要指示新的子项是可写 ；否则为false。 要使用的注册表选项。 为 null。 未指定有效的选项 用户没有创建或打开该注册表项所需的权限。 无法写入当前 ；例如，它未作为可写入项打开，或用户不具有必要的访问权限。 嵌套级别超过 510。- 或 -发生系统错误，例如，删除了项，或者尝试在 根中创建项。

删除指定子项。

要删除的子项的名称。此字符串不区分大小写。 有子级子项 参数未指定有效的注册表项 为null 用户没有删除该项所需的权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。

删除指定的子项，并指定在找不到该子项时是否引发异常。

要删除的子项的名称。此字符串不区分大小写。 指示在找不到指定子项的情况下是否引发异常。如果该参数为 true，并且指定的子项不存在，则引发异常。如果该参数为 false，并且指定的子项不存在，则不执行任何操作。 有子级子项。 未指定有效的注册表项，并且 为 true。 为 null。 用户没有删除该项所需的权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。

递归删除子项和任何子级子项。

要删除的子项。此字符串不区分大小写。 为 null。 尝试删除根配置单元。- 或 - 未指定有效的注册表子项。 出现 I/O 错误。 用户没有删除该项所需的权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。

以递归方式删除指定的子项和任何子级子项，并指定在找不到子项时是否引发异常。

要删除的子项的名称。此字符串不区分大小写。 指示在找不到指定子项的情况下是否引发异常。如果该参数为 true，并且指定的子项不存在，则引发异常。如果该参数为 false，并且指定的子项不存在，则不执行任何操作。 尝试删除树的根配置单元。- 或 - 未指定有效的注册表子项，并且 为 true。 为 null。 已关闭（无法访问已关闭的项）。 用户没有必需的注册表权限。 用户没有删除该项所需的权限。

从此项中删除指定值。

要删除的值的名称。 不是对值的有效引用。 用户没有删除该值所需的权限。 要操作的 已关闭（无法访问关闭的项）。 正在处理的 为只读。

从此项中删除指定的值，并指定在找不到该值时是否引发异常。

要删除的值的名称。 指示在找不到指定值的情况下是否引发异常。如果该参数为 true，并且指定的值不存在，则引发异常。如果该参数为 false，并且指定的值不存在，则不执行任何操作。 不是对值的有效引用，并且 为 true。- 或 - 为 null。 用户没有删除该值所需的权限。 要操作的 已关闭（无法访问关闭的项）。 正在处理的 为只读。

释放由 类的当前实例占用的所有资源。

将指定的打开注册表项的全部特性写到注册表中。

[SECURITY CRITICAL] 根据指定的句柄创建注册表项。

注册表项。 注册表项的句柄。

[SECURITY CRITICAL] 利用指定的句柄和注册表视图设置创建注册表项。

注册表项。 注册表项的句柄。 要使用的注册表视图。

检索包含所有子项名称的字符串数组。

包含当前项的子项名称的字符串数组。 用户没有读取该项所需的权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。 发生系统错误，例如，当前项已被删除。

检索与指定名称关联的值。如果注册表中不存在名称/值对，则返回 null。

与 关联的值；如果未找到 ，则为 null。 要检索的值的名称。此字符串不区分大小写。 该用户没有读取注册表项所需的权限。 包含指定值的 已关闭（无法访问关闭的项）。 包含指定值的 已标记为删除。 用户没有必需的注册表权限。

检索与指定名称关联的值。如果未找到名称，则返回你提供的默认值。

与 关联的值，不展开嵌入的任何环境变量；如果未找到 ，则为 。 要检索的值的名称。此字符串不区分大小写。 当 不存在时返回的值。 该用户没有读取注册表项所需的权限。 包含指定值的 已关闭（无法访问关闭的项）。 包含指定值的 已标记为删除。 用户没有必需的注册表权限。

检索与指定的名称和检索选项关联的值。如果未找到名称，则返回你提供的默认值。

与 关联的值，按指定的 对其进行处理；如果未找到 ，则为 。 要检索的值的名称。此字符串不区分大小写。 当 不存在时返回的值。 枚举值之一，它指定对所检索值的可选处理方式。 该用户没有读取注册表项所需的权限。 包含指定值的 已关闭（无法访问关闭的项）。 包含指定值的 已标记为删除。 不是有效的 值；例如，无效值将强制转换为 。 用户没有必需的注册表权限。

检索与指定名称关联的值的注册表数据类型。

与 关联的值的注册表数据类型。 要检索其注册表数据类型的值的名称。此字符串不区分大小写。 该用户没有读取注册表项所需的权限。 包含指定值的 已关闭（无法访问关闭的项）。 包含指定值的子项不存在。- 或 -由 指定的名称/值对不存在。在 Windows 95、Windows 98 或 Windows Millennium Edition 中不引发此异常。 用户没有必需的注册表权限。

检索包含与此项关联的所有值名称的字符串数组。

包含当前项的值名称的字符串数组。 该用户没有读取注册表项所需的权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。 发生系统错误；例如，当前项已被删除。

[SECURITY CRITICAL] 获取一个 对象，该对象表示当前 对象封装的注册表项。

注册表项的句柄。

检索项的名称。

项的绝对（限定）名称。 已关闭（无法访问已关闭的项）。

打开一个新的 ，它使用指定的视图在本地计算机上表示请求的项。

请求的注册表项。 要打开的 HKEY。 要使用的注册表视图。 或 无效。 用户没有必需的注册表权限。 用户没有执行此操作所需的权限。

以只读方式检索子项。

请求的子项；如果操作失败，则为 null。 要以只读方式打开的子项的名称或路径。 为null 已关闭（无法访问已关闭的项）。 用户没有读取注册表项所需的权限。

检索指定的子项，并指定是否将写访问权限应用于该项。

请求的子项；如果操作失败，则为 null。 要打开的子项的名称或路径。 如果需要项的写访问权限，则设置为 true。 为 null。 已关闭（无法访问已关闭的项）。 用户没有在指定模式下访问注册表项所需的权限。

检索具有指定名称的子项。从开始，提供.NET Framework 2015

请求的子项；如果操作失败，则为 null。 要创建或打开的子项的名称或路径。 注册表项的权限。 为 null。 已关闭（无法访问已关闭的项）。 用户没有在指定模式下访问注册表项所需的权限。

设置指定的名称/值对。

要存储的值的名称。 要存储的数据。 为 null。 不是受支持的数据类型。 包含指定值的 已关闭（无法访问关闭的项）。 只读，因此无法写入；例如，项不是用写访问权限打开的。- 或 - 对象表示根级别节点，操作系统为 Windows Millennium Edition 或 Windows 98。 用户没有创建或修改注册表项所需的权限。 对象表示根级别节点，操作系统为 Windows 2000、Windows XP 或 Windows Server 2003。

使用指定的注册表数据类型设置注册表项中的名称/值对的值。

要存储的值的名称。 要存储的数据。 在存储数据时要使用的注册表数据类型。 为 null。 的类型与 指定的注册表数据类型不匹配，因此，未能正确转换该数据。 包含指定值的 已关闭（无法访问关闭的项）。 只读，因此无法写入；例如，项不是用写访问权限打开的。- 或 - 对象表示根级别节点，操作系统为 Windows Millennium Edition 或 Windows 98。 用户没有创建或修改注册表项所需的权限。 对象表示根级别节点，操作系统为 Windows 2000、Windows XP 或 Windows Server 2003。

检索当前项的子项计数。

当前项的子项的数目。 用户没有该项的读取权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。 发生系统错误，例如，当前项已被删除。

检索此项的字符串表示形式。

表示此项的字符串。如果指定的项无效（找不到），则返回 null。 访问的 已关闭（无法访问关闭的项）。

检索项中值的计数。

项中的名称/值对的数目。 用户没有该项的读取权限。 要操作的 已关闭（无法访问关闭的项）。 用户没有必需的注册表权限。 发生系统错误，例如，当前项已被删除。

获取用于创建注册表项的视图。

用于创建注册表项的视图。- 或 -如果未使用视图，则为 。

指定在创建注册表项时使用的选项。

不可变的项。这是默认设置。

可变的键。此信息存储在内存中，并且在卸载相应的注册表配置单元时不保留此信息。

指定在注册表中存储值时所用的数据类型，或标识注册表中某个值的数据类型。

任意格式的二进制数据。此值与 Win32 API 注册表数据类型 REG_BINARY 等效。

一个 32 位二进制数。此值与 Win32 API 注册表数据类型 REG_DWORD 等效。

一个以 NULL 结尾的字符串，该字符串中包含对环境变量（如 %PATH%）的未展开的引用。当检索值时，该引用将会展开。此值与 Win32 API 注册表数据类型 REG_EXPAND_SZ 等效。

一个以 NULL 结尾的字符串数组，以两个空字符结束。此值与 Win32 API 注册表数据类型 REG_MULTI_SZ 等效。

无数据类型。

一个 64 位二进制数。此值与 Win32 API 注册表数据类型 REG_QWORD 等效。

一个以 NULL 结尾的字符串。此值与 Win32 API 注册表数据类型 REG_SZ 等效。

一个不受支持的注册表数据类型。例如，不支持 Microsoft Win32 API 注册表数据类型 REG_RESOURCE_LIST。使用此值指定 方法应在存储名称/值对时确定适当的注册表数据类型。

指定从注册表项检索名称/值对时的可选行为。

检索类型为 的值，而不扩展它的嵌入式环境变量。

未指定可选行为。

指定要在 64 位操作系统上针对的注册表视图。

默认视图。

32 位视图。

64 位视图。

[SECURITY CRITICAL] 表示 Windows 注册表的安全句柄。

[SECURITY CRITICAL] 初始化 类的新实例。

一个对象，它表示要使用的预先存在的句柄。 如果为 true，则在完成阶段可靠地释放句柄；如果为 false，则阻止可靠释放。

指定能够应用于注册表对象的访问控制权限。

更改与某个注册表项关联的访问规则和审核规则的权限。

保留供系统使用。

创建某个注册表项的子项的权限。

删除某个注册表项的权限。

列出某个注册表项的子项的权限。

与 相同。

对某个注册表项进行完全控制并修改其访问规则和审核规则的权限。

请求获得关于某个注册表项的更改通知的权限。

查询某个注册表项中的名称/值对的权限。

查询某个注册表项中的名称/值对、请求获得更改通知、枚举其子项以及读取其访问规则和审核规则的权限。

打开并复制某个注册表项的访问规则和审核规则的权限。

创建、删除或设置某个注册表项中的名称/值对的权限。

更改某个注册表项的所有者的权限。

创建、删除和设置某个注册表项中的名称/值对以及创建或删除子项、请求获得更改通知、对其子项进行枚举和读取其访问规则和审核规则的权限。