扁平命令式支持库(不是类)。路径:支持库 → 基础支持库 → 注册表。
硬约束
- 扁平命令;写 HKLM 等受保护位置通常需要管理员权限。
- 根键可用文本(如
HKEY_CURRENT_USER)或约定整数/常量——以签名与面板为准。 - 读不到键值时常见返回空文本 / 0 / 假,先判断键是否存在。
- 删除键会递归影响子键,操作前确认路径。
- 仅在确有需要时写注册表;错误路径可能导致软件配置损坏。
快速开始
文本 根 = "HKEY_CURRENT_USER"
文本 项 = "Software\YyuyanDemo"
// 具体命令名以签名表为准
输出("见下方完整签名表;读写前请确认权限与路径")
注册表
本分类共 9 条。
写注册表文本
- 签名:
逻辑 写注册表文本(文本 根键, 文本 子键路径, 文本 值名, 文本 值, [整数 值类型=1]) - 说明:写入注册表文本值(等同于「写注册项」)。
- 参数一│根键
- 参数二│子键路径
- 参数三│值名
- 参数四│值
- 参数五│[值类型=1]: 1=文本,4=整数
写注册项
- 签名:
逻辑 写注册项(文本 根键, 文本 子键路径, 文本 值名, 文本 值, [整数 值类型=1]) - 说明:写入或覆盖注册表值;子键不存在时会自动创建。成功返回真。
- 参数一│根键: 如 当前用户、本地机器
- 参数二│子键路径: 目标子键
- 参数三│值名: 值名称
- 参数四│值: 要写入的内容
- 参数五│[值类型=1]: 1=文本,4=整数
删除注册子键
- 签名:
逻辑 删除注册子键(文本 根键, 文本 子键路径) - 说明:删除指定子键(该键下不能再有子键,否则失败)。
- 参数一│根键
- 参数二│子键路径: 要删除的子键完整路径
删除注册项
- 签名:
逻辑 删除注册项(文本 根键, 文本 子键路径, 文本 值名) - 说明:删除指定子键下的某个值(不是删除整个子键)。
- 参数一│根键
- 参数二│子键路径
- 参数三│值名: 要删除的值名
取注册值名称列表
- 签名:
文本数组 取注册值名称列表(文本 根键, 文本 子键路径) - 说明:列出指定子键下全部值的名称,返回文本数组。
- 参数一│根键
- 参数二│子键路径
取注册子键列表
- 签名:
文本数组 取注册子键列表(文本 根键, 文本 子键路径) - 说明:列出指定子键下的全部子键名称,返回文本数组。
- 参数一│根键
- 参数二│子键路径: 空文本表示根键下一级
注册项是否存在
- 签名:
逻辑 注册项是否存在(文本 根键, 文本 子键路径, 文本 值名) - 说明:判断指定注册值是否存在。
- 参数一│根键
- 参数二│子键路径
- 参数三│值名
读注册表文本
- 签名:
文本 读注册表文本(文本 根键, 文本 子键路径, 文本 值名, [文本 默认值=""]) - 说明:读取注册表文本值(等同于「读注册项」)。
- 参数一│根键
- 参数二│子键路径
- 参数三│值名
- 参数四│[默认值=”“]: 可选
读注册项
- 签名:
文本 读注册项(文本 根键, 文本 子键路径, 文本 值名, [文本 默认值=""]) - 说明:读取指定根键、子键下某注册值的文本表示;值不存在或读取失败时返回默认值。整数型值返回十进制文本;二进制值返回十六进制文本。
- 参数一│根键: 如 当前用户、本地机器、类根
- 参数二│子键路径: 如 Software\MyCompany\MyApp
- 参数三│值名: 要读取的值名称;默认项可传空文本
- 参数四│[默认值=”“]: 可选,读失败时返回
易错对照
| 错误 | 正确 |
|---|---|
| 路径分隔符写错 | 注册表项用 \\ 或面板提示的分隔 |
| 无管理员写 HKLM | 失败;改 HKCU 或提权 |
| 删除键未确认 | 可能删掉整棵子树 |