API 参考

本节提供 Apq.Cfg 的完整 API 参考文档。

文档基于 .NET 10.0 生成，API 与 .NET 8.0 版本完全兼容。

命名空间

核心

• Apq.Cfg - 核心配置组件
• Apq.Cfg.Sources - 配置源接口
• Apq.Cfg.Changes - 动态重载
• Apq.Cfg.Security - 安全接口
• Apq.Cfg.DependencyInjection - 依赖注入
• Apq.Cfg.EncodingSupport - 编码支持

配置验证

• Apq.Cfg.Validation - 配置验证核心
• Apq.Cfg.Validation.Rules - 验证规则（Required、Range、Regex、OneOf、Length、DependsOn、Custom）

模板引擎

• Apq.Cfg.Template - 变量替换（支持 ${Key}、${ENV:Name}、${SYS:Property} 语法）

快照导出

• Apq.Cfg.Snapshot - 配置快照导出（JSON、YAML、TOML、INI、XML、Env）

加密脱敏

• Apq.Cfg.Crypto - 加密脱敏核心
• Apq.Cfg.Crypto.Providers - 加密提供程序
• Apq.Cfg.Crypto.DataProtection - ASP.NET Core Data Protection 实现

命令行工具

• Apq.Cfg.Crypto.Tool - 配置加密 CLI 工具 (apqenc)

本地配置源

• Apq.Cfg.Ini - INI 格式
• Apq.Cfg.Xml - XML 格式
• Apq.Cfg.Yaml - YAML 格式
• Apq.Cfg.Toml - TOML 格式
• Apq.Cfg.Env - 环境变量/.env 文件

数据存储配置源

• Apq.Cfg.Redis - Redis 配置源
• Apq.Cfg.Database - 数据库配置源

远程配置中心

• Apq.Cfg.Consul - Consul 配置中心
• Apq.Cfg.Etcd - Etcd 配置中心
• Apq.Cfg.Nacos - Nacos 配置中心
• Apq.Cfg.Apollo - Apollo 配置中心
• Apq.Cfg.Zookeeper - Zookeeper 配置中心
• Apq.Cfg.Vault - HashiCorp Vault

源生成器

• Apq.Cfg.SourceGenerator - 编译时强类型配置绑定（Native AOT）