Liwendong.Resources 2.0.1

Liwendong.Resources

静态资源集合：行政区划、汉字与拼音、MIME 类型、时间常量、常用提示语、证件号码规则、单位换算、HTTP 状态码。

零外部依赖，覆盖 net8.0 / netstandard2.1 / netstandard2.0 / net451 / net46。

安装

Install-Package Liwendong.Resources

dotnet add package Liwendong.Resources

内容一览

用法示例

行政区划三级联动

foreach (AreaItem province in AreaResources.Provinces)
{
    Console.WriteLine($"{province.Code} {province.Name}");
}

IReadOnlyList<AreaItem> cities = AreaResources.GetCities(130000);      // 河北省下辖地市
IReadOnlyList<AreaItem> districts = AreaResources.GetDistricts(130100); // 石家庄下辖区县

AreaResources.GetFullName(130102);           // "河北省 石家庄市 长安区"
AreaResources.GetDistricts(110000);          // 直辖市会穿透「市辖区」直接返回真实区
AreaResources.GetName(440305);               // "南山区"
AreaResources.FindByName("湖里区");           // 同名返回多条

数据出自民政部公布的 2024 年度县级以上行政区划代码：省级 34 项、地级 343 项、县级 3332 项。 台湾省、香港特别行政区、澳门特别行政区只有省级条目。 直辖市下的「市辖区 / 县」、部分省份的「省直辖县级行政区划」是 GB/T 2260 的汇总节点， 可用 AreaItem.IsSummaryNode 识别。

MIME 类型

IOResources.GetContentType("report.PDF");        // application/pdf
IOResources.GetContentType("/wwwroot/a/b.PNG");  // image/png（路径、大小写、带不带点都行）
IOResources.GetContentType("http://x/y.mp4?t=1");// video/mp4（自动去掉查询串）
IOResources.GetContentType("zzz");               // application/octet-stream（兜底）

IOResources.GetExtensions("image/jpeg");         // 反查扩展名
IOResources.IsImage("a.svg");                    // true
IOResources.IsArchive("a.7z");                   // true
IOResources.IsFont("a.woff2");                   // true

表内共 639 条映射，查询大小写不敏感。

汉字与拼音

ChineseCharacterResources.GetGB2312String();              // GB2312 一级汉字 3755 个
ChineseCharacterResources.GetChinese3500().Count;         // 3500（V1 实际只有 161）
ChineseCharacterResources.GetChinese2500().Count;         // 2500（V1 实际只有 28）

int code;
ChineseCharacterResources.TryGetGb2312Level1Code('啊', out code);  // 45217 == 0xB0A1

ChineseCharacterResources.FirstNames;   // 百家姓（已切分，不用每次 Split）
ChineseCharacterResources.NationNames;  // 56 个民族

TryGetGb2312Level1Code 提供的值为 (高位字节 << 8 & 0xff00) + (低位字节 & 0xff)， 可直接与 FirstPinYinCodes / PinYinCodes 配合做拼音检索。 之所以需要它：现代 .NET 已不内建 GB2312 编码表，Encoding.GetEncoding("GB2312") 会抛异常。

其它

TimeResources.GetFullName3();                                  // 见下行
TimeResources.GetWeekdayName(DayOfWeek.Wednesday);             // "星期三"
TipsResources.GetTip("SaveSuccess");                           // "保存成功"
IdentityResources.GetIdCardCheckCode("11010519491231002");      // 'X'
IdentityResources.GetIdCardProvince("11010519491231002X");      // "北京市"
UnitResources.FormatBytes(1536);                                // "1.50 KB"
UnitResources.Convert(1, UnitResources.LengthUnits, "mi", "m"); // 1609.344
HttpStatusResources.GetReasonPhrase(404);                       // "Not Found"

V1 → V2 迁移说明

V2 修复了 V1 的若干缺陷并收敛了 API，这是一次破坏性升级（见下方逐一说明）。

1. 行为修正

若此前依赖以上内容做过「随机中文名字.DBConn / 随机常用字」之类功能，升级后会明显变化 —— 这是修正而非回归。

2. 类型收敛为只读集合

公开的可变静态字段收敛成了只读集合，目的是避免外部代码改写共享数据。 放开不一定报错，多数是 数组.Length 与索引处需要调整：

TipsResources 的常量仍是 const string，可继续用作默认参数值。

3. 拼写修正（旧成员保留一个大版本）

这三个旧成员将在 V3.0 移除，请尽快替换。

更新日志

2.0.1 (2026-10-17)

• 修复：UnitResources.Convert 未知单位不再静默返回原值，改为抛出 ArgumentException（方法名保持不变，XML 注释说明与 System.Convert 的区别：本方法是单位换算而非类型转换）。
• 修复：TipsResources.FuctionNotOpen 文案"尽情期待"更正为"敬请期待"；XML 注释注明 FuctionNotOpen（应为 FunctionNotOpen）与 Faild 系列（应为 Failed）的正确拼写，公共成员名保持不变。
• 优化：TimeResources 注释明确 Seconds_Year_1 = 31536000 为平年 365 天、Seconds_Month_1 = 2592000 为 30 天近似值。

V2.0.0

• 修复：GetGB2312String() 低位字节误用区号，实际只产出 40 个不同汉字（下游 2500/3500 常用字只剩 28 / 161 个）
• 修复：去掉对 Encoding.GetEncoding("GB2312") 的依赖，该方法在 .NET Core / .NET 5 及以上直接抛异常
• 修复：TargetFrameworks 写成非标准的 netstandard20
• 修复：CityNames 数据被截断且含重复 / 过时 / 非行政区条目
• 修复：TimeResources.Seconds_Houre_8 注释写成「4小时」（实为 8 小时）
• 修复：FirstPinyinChineseCharacter 等缺少 readonly，GetChinese2500/3500 每次调用重建 HashSet
• 新增：目标框架 net8.0 / netstandard2.1，net8.0 下用 FrozenDictionary 优化查表
• 新增：行政区划三级数据（民政部 2024 年度，3709 条）与 9 个查询方法
• 新增：MIME 查询 API（GetContentType / GetExtensions / IsImage 等）+ 73 条现代类型
• 新增：IdentityResources、UnitResources、HttpStatusResources
• 新增：TimeResources 的 ISO8601 / RFC1123 格式串、TimeSpan 常量、星期与月份名称
• 新增：TipsResources 扩充至 40+ 条并按场景分组
• 优化：公开成员统一收敛为只读集合；FirstName / LastName / NationName 增加已切分版本
• 工程：补齐包元数据、IncludeSymbols（snupkg）、GenerateDocumentationFile；清理 TFS 时代残留

V1.1.0

• 新增区域资源

V1.0.5

• 调整时间转成秒针的资源信息