开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载Humanizer 中的LetterCasing枚举定义了字符串输出所需的四种大小写风格Title、AllCaps、LowerCase、Sentence是ApplyCase、字符串Humanize、枚举Humanize等核心 API 的公共开关。本文以 Humanizer.LetterCasing API 文档 为骨架结合源码与测试完整讲解每个枚举成员的确切行为、调用方式、底层 Transformer 机制与常见注意事项读完即可在 .NET 项目中精确控制任何字符串、枚举名称的显示大小写。LetterCasing 枚举四个成员与官方语义LetterCasing位于Humanizer命名空间是驱动字符串大小写转换的标准枚举。其官方定义见 LetterCasing.cs原文注释明确说明其用途为 Options for specifying the desired letter casing for the output string为输出字符串指定期望的大小写风格。成员枚举值官方示例语义Title0SomeString - Some String标题大小写每个单词首字母大写AllCaps1SomeString - SOME STRING全大写LowerCase2SomeString - some string全小写Sentence3SomeString - Some string句子大小写仅首字符大写其余保持原样四个成员覆盖了开发中最常见的四种文本展示需求标题/栏目名Title、强调或告警AllCaps、统一小写存储与匹配LowerCase、自然语句Sentence。核心入口一ApplyCase扩展方法LetterCasing最直接的消费方是 CasingExtensions.cs 中的ApplyCase扩展方法它把枚举值映射到对应的字符串变换器public static string ApplyCase(this string input, LetterCasing casing) casing switch { LetterCasing.Title input.Transform(To.TitleCase), LetterCasing.LowerCase input.Transform(To.LowerCase), LetterCasing.AllCaps input.Transform(To.UpperCase), LetterCasing.Sentence input.Transform(To.SentenceCase), _ throw new ArgumentOutOfRangeException(nameof(casing)) };行为示例取自源码 XML 注释some string.ApplyCase(LetterCasing.Title) // Some String SOME STRING.ApplyCase(LetterCasing.LowerCase) // some string some string.ApplyCase(LetterCasing.AllCaps) // SOME STRING some string.ApplyCase(LetterCasing.Sentence) // Some string关于非法值的异常处理注意switch表达式的兜底分支传入不在 0~3 范围内的值会抛出ArgumentOutOfRangeException。这一点在 EnumHumanizeTests.cs 中有对应验证Assert.ThrowsArgumentOutOfRangeException(() value.Humanize((LetterCasing)42))。核心入口二字符串Humanize(LetterCasing)组合LetterCasing最常见的实际用途是与Humanize配合把 PascalCase / 下划线 / 连字符文本先拆分再套用大小写。实现在 StringHumanizeExtensions.cspublic static string Humanize(this string input, LetterCasing casing) input .Humanize() .ApplyCase(casing);即先执行无参数的Humanize()拆分单词、处理首字母缩写与下划线/连字符再套用指定大小写。官方注释示例PascalCaseInputString.Humanize(LetterCasing.AllCaps) // PASCAL CASE INPUT STRING PascalCaseInputString.Humanize(LetterCasing.LowerCase) // pascal case input string PascalCaseInputString.Humanize(LetterCasing.Title) // Pascal Case Input String测试用例 StringHumanizeTests.cs 也验证了组合行为的细节例如土耳其语文化下的标题转换[Theory, UseCulture(tr-TR)] [InlineData(istanbulInputString, İstanbul Input String)] public void CanHumanizeStringIntoTitleCaseInTurkish(...)这条测试同时印证了LetterCasing.Title会尊重tr-TR这类需要特殊大小写规则的文化。核心入口三枚举Humanize(LetterCasing)LetterCasing也可作为枚举人性化输出的参数定义在 EnumHumanizeExtensions.cspublic static string Humanize[DynamicallyAccessedMembers(...)] T(this T input, LetterCasing casing) where T : struct, Enum Humanize(input, casing, EnumHumanizeSource.Default);官方示例enum UserType { AnonymousUser, RegisteredUser } UserType.AnonymousUser.Humanize(LetterCasing.AllCaps) // ANONYMOUS USER UserType.AnonymousUser.Humanize(LetterCasing.Title) // Anonymous User UserType.AnonymousUser.Humanize(LetterCasing.LowerCase) // anonymous user测试还表明当枚举成员带有DescriptionAttribute或DisplayAttribute时四种LetterCasing都不会改写属性中的既定文本见 EnumHumanizeTests.cs 中CasingPreservesDescriptionAttribute/CasingPreservesDisplayAttribute两个 Theory这与“属性文本优先、否则按成员名拆分”的设计一致。除上述入口外InflectorExtensions的标题化方法内部也复用了ApplyCase(LetterCasing.Title)见 InflectorExtensions.cs可见该枚举是整个大小写体系的公共基础。底层原理Transformer 机制ApplyCase最终把工作委托给To门户To.cs上的四个ICulturedStringTransformer单例To.TitleCase、To.LowerCase、To.UpperCase、To.SentenceCase。它们支持两个重载无文化参数时使用CultureInfo.CurrentCulture也可显式传入CultureInfo进行文化敏感转换public static string Transform(this string input, CultureInfo culture, params ICulturedStringTransformer[] transformers)因此LetterCasing的大小写行为在根本上是由当前线程文化或显式传入文化的TextInfo驱动的。Title 大小写的精妙细节ToTitleCase.cs 是四个变换器中最复杂的值得单独展开双路径设计纯 ASCII 输入走高性能的TryTransformAscii快速路径逐字符扫描、按需复制到char[]缓冲一旦遇到非 ASCII 字符则回退到正则路径TransformWithRegex正则模式为(\w|[^\u0000-\u007F])?\w*兼容撇号收缩词如dont。在 .NET 7 上该正则使用[GeneratedRegex]生成。全大写单词保留原样AllAsciiCapitals/AllCapitals判断使HTML、USA这类单词不会被错误改写与测试中HTML - HTML的断言一致。冠词/连词/介词小写化位于非句首的a, an, as, at, by, if, in, of, on, or, so, to, up, and, but, for, nor, off, the, via, yet保持小写这是标题大小写的经典排版规则见IsArticleOrConjunctionOrPreposition方法。测试 CasingTests.cs 中title case (with parenthesis) - Title Case (With Parenthesis)也验证了括号内单词同样参与处理。文化敏感 ASCII 大写当文化为tr土耳其语或az阿塞拜疆语前缀时UsesCultureSensitiveAsciiCasing返回true大小写转换改走TextInfo.ToUpper/ToLower从而正确处理土耳其语点号问题如istanbul在 tr-TR 下转为İstanbul。Sentence 大小写的极简语义ToSentenceCase.cs 实现非常克制仅当输入非空且首字符不是大写时用TextInfo.ToUpper大写首字符其余字符一律不动。这与 .NET 自带的ToTitleCase会强制小写其余字符不同也是Sentence与Title的核心区别。测试中的三组断言清楚展示了这一行为lower case statement.ApplyCase(LetterCasing.Sentence) // Lower case statement Sentence casing.ApplyCase(LetterCasing.Sentence) // Sentence casing首字符已大写原样返回 honors UPPER case.ApplyCase(LetterCasing.Sentence) // Honors UPPER case其余字符不被小写化测试验证一览仓库测试为四种大小写策略提供了完整的行为契约CasingTests.csApplyCase四个成员各自的 Theory 断言覆盖标题保留大写、句子仅改首字符、全大/小写等边界。StringHumanizeTests.csHumanize(LetterCasing)组合行为含 tr-TR 文化的标题转换与阿拉伯语 Unicode 保留。EnumHumanizeTests.cs枚举 LetterCasing的四档行为、Description/Display 属性保留、非法值异常。使用建议与注意事项区分Title与Sentence需要整句标题排版用Title只需句首大写、保留句中既有大小写如专有名词时用Sentence。文化一致性LetterCasing的所有转换默认受CultureInfo.CurrentCulture影响涉及土耳其语等特殊大小写规则时应确保运行环境文化正确或显式传入文化。枚举属性优先对带Description/Display特性的枚举成员Humanize(LetterCasing)不会改写属性文本请勿期望通过 casing 参数改变这类既定输出。非法值防护库会对越界枚举值抛出ArgumentOutOfRangeException调用方应只传Title、AllCaps、LowerCase、Sentence四者之一。性能纯 ASCII 输入在Title下走免正则的快速路径批量处理标识符类文本时天然高效含非 ASCII 字符时自动回退正则路径无需调用方干预。将LetterCasing与ApplyCase、Humanize组合使用即可在展示层、日志层、报表标题等场景下以统一、可测试的方式完成全部大小写需求这正是 Humanizer 围绕该枚举建立的完整能力闭环。赞分享开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载相关推荐Humanizer 的 LetterCasing 枚举四种字符串大小写转换的完整指南Humanizer 的 LetterCasing 枚举四种字符串大小写转换的完整指南 导读 LetterCasing 是 Humanizer 库中定义输出字符开发工具Humanizer 字符串大小写转换指南LetterCasing 枚举与 ApplyCase 深入解析Humanizer 字符串大小写转换指南LetterCasing 枚举与 ApplyCase 深入解析 LetterCasing 是 .NET 字符串处理库开发工具Humanizer 的 LetterCasing 枚举详解Title、AllCaps、LowerCase 与 Sentence 四种字符串大小写转换Humanizer 的 LetterCasing 枚举详解Title、AllCaps、LowerCase 与 Sentence 四种字符串大小写转换 导读 L开发工具上一篇nosurf完全指南如何用Go语言打造安全无虞的CSRF防护中间件下一篇Laravel Installer 教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考