• 桌面应用
• 开发工具

XML Notepad 在加载 XML Schema（XSD）进行校验的同时，会复用同一套 Schema 为编辑器提供智能提示（Intellisense）：插入新节点时提示合法的元素名与属性名，编辑取值时提示枚举候选值，并为日期、时间、颜色等常见数据类型提供专用编辑器。读完本文，你将掌握 XML Notepad 智能提示的完整工作方式、如何在 Schema 中声明枚举与自定义编辑器/构建器，以及其底层实现（XmlIntellisenseProvider、Checker、SchemaCache）是如何联动工作的。

一、智能提示从哪来：Schema 即提示源

XML Notepad 的核心设计是"一次 Schema，两处使用"：用于校验的 XML Schema，同时也驱动智能提示。你不需要额外配置任何提示规则——只要通过View 菜单 → Schemas...对话框加载了目标 Schema，编辑器就会根据光标所在位置的 Schema 上下文自动给出候选。

这与"通用 XML 编辑器只做关键字补全"的思路不同：XML Notepad 的提示是语义级的，它由 .NET 的XmlSchemaValidator在游标当前位置实时计算"下一步合法出现什么"得出。从源码结构看，这一职责由Checker承担：

• Checker.cs 定义了三类"提示位置"枚举IntellisensePosition { OnNode, AfterNode, FirstChild }，并在ValidateElement中通过_validator.GetExpectedParticles()/_validator.GetExpectedAttributes()捕获当前节点允许出现的元素粒子与属性集合；
• 当你在属性节点上编辑时，XmlIntellisenseProvider.cs 的GetExpectedNames()会遍历checker.GetExpectedAttributes()，把每个XmlSchemaAttribute的限定名（含命名空间前缀）加入候选列表；在元素节点上则遍历checker.GetExpectedParticles()，将每个XmlSchemaElement加入候选；
• 每个候选还可以携带 Schema 注解中的 Tooltip（SchemaCache.GetAnnotation(..., AnnotationNode.Tooltip, ...)），在真实编辑器中表现为下拉项旁的工具提示。

二、元素与属性名的候选提示：以 xsd:choice 为例

官方文档给出了最直观的例子：假设 Schema 中用<xsd:choice>定义了元素 "fruit"、"vegetable"、"berry" 三选一，那么当你在该位置插入新节点时，XML Notepad 会弹出下拉框列出这三个候选：

仓库测试用 Schema emp.xsd 中就有真实场景：

<xs:choice> <xs:element name="Zip" type="xs:int"/> <xs:element name="postalCode" type="xs:string"/> </xs:choice>

在这个位置插入子节点时，下拉只会出现Zip与postalCode两个选项。同理，为EmployeeAttributes属性组（emp.xsd）添加属性时，提示为id、hireDate、title、fullTime这四个由xs:attributeGroup定义的合法属性。

几个值得注意的实现细节：

• 命名空间前缀自动补全：候选名称不是裸的 localName。XmlIntellisenseProvider.GetQualifiedName会根据当前元素已声明的命名空间前缀，把候选渲染为prefix:name形式（XmlIntellisenseProvider.cs），保证插入的元素带正确的命名空间；
• 开放式候选：如果 Schema 粒子包含xsd:any，GetExpectedNames会把列表标记为IsOpen = true（XmlIntellisenseProvider.cs），表示允许用户输入列表之外的任意名称；
• 空文档兜底：当新文档还没有根元素时，_checker为空，GetExpectedNames会回退到模型级Checker（XmlIntellisenseProvider.cs），从而在新建文档中也能提示 Schema 定义的顶级根元素，选择后元素会自动与正确的命名空间关联，提示链由此延续。

三、取值的候选提示：枚举（enumeration）与内置类型

与元素名提示对称，如果 Schema 为某个 simpleType 定义了<xsd:enumeration>取值约束，那么编辑该节点值时，XML Notepad 会把整份合法取值列表作为下拉候选：

值的候选由SchemaCache.GetExpectedValues(XmlSchemaType)计算（SchemaCache.cs），它会沿 simpleType 的派生链递归收集：

• 枚举 facet：遍历XmlSchemaSimpleTypeRestriction.Facets，把所有XmlSchemaEnumerationFacet的Value加入候选，同时把该枚举项的注解作为 Tooltip；
• 列表类型（xsd:list）：递归到ItemType收集其候选值；
• 联合类型（xsd:union）：逐个遍历BaseMemberTypes收集；
• 限制类型（xsd:restriction）：先递归收集基类型候选，再叠加自身的枚举；
• 内置便捷类型：xsd:boolean直接给出0/1/true/false四个候选；xsd:language则枚举当前系统全部CultureInfo名称（如en-us），并以其DisplayName作为提示文字。

仓库测试用 Schema 中，Role就是一个典型的枚举类型（emp.xsd），编辑title属性值时下拉会出现Architect、GPM、PM Lead、SDE、Test Manager等全部候选。

四、输入交互：渐进匹配与 ENTER 确认

下拉框的交互设计非常顺手：

• 渐进匹配：随着你逐字符输入，与已输入字母匹配的项会被自动选中（前缀/包含匹配），无需用方向键翻找；
• ENTER 确认：按下 ENTER 后选中项立即写入编辑框，智能提示完成，整串内容无需手动敲完，对于冗长的枚举值或带前缀的限定名能显著提升编辑效率；
• 未命中可自由输入：当候选列表被标记为IsOpen（如含xsd:any的情况），你可以输入任何列表外的文本，提示不会拦截。

这一交互链路在 TextEditorOverlay.cs 的BeginEdit中实现：编辑值时调用provider.GetExpectedValues()，编辑名称时调用provider.GetExpectedNames()，只要候选列表非空或存在 builder，就通过CompletionSet弹出下拉框。编辑器的上下文节点由TreeView.BeginEdit先通过provider.SetContextNode(sel)设置好（TreeView.cs），确保提示与光标所在 Schema 位置严格一致。

五、自定义编辑器（Custom Editors）：日期、时间开箱即用

除了文本下拉提示，XML Notepad 对已知数据类型提供专用编辑控件（详见自定义编辑器文档）。默认对xsd:date、xsd:dateTime、xsd:time三种 simpleType 绑定 WinFormsDateTimePicker，并按当前系统区域设置格式化：

• 日期类型使用短日期格式（Short）；
• 时间类型使用DateTimePickerFormat.Time并启用上下微调（ShowUpDown = true）；
• 日期时间类型使用ShortDatePattern + " " + LongTimePattern的自定义格式。

这些行为在 Builders.cs 的DateTimeEditor.SchemaTypesetter 中按XmlTypeCode分支配置，序列化回 XML 时通过XmlConvert.ToString输出符合 XSD 规范的字符串（Builders.cs）。

类型到编辑器的映射逻辑位于XmlIntellisenseProvider.Editor（XmlIntellisenseProvider.cs）：优先读取 Schema 上的vs:editor注解，未指定时按类型码默认匹配Date/DateTime/Time。

六、自定义构建器（Custom Builders）：文件浏览与颜色选择

构建器（Builder）与编辑器不同：它不是替换内联编辑控件，而是在提示列表顶部显示一个按钮，点击后弹出模态对话框编辑该值。

1. URI/文件路径构建器（默认内置）

XmlNotepad.UriBuilder被默认绑定到xsd:anyURI类型（XmlIntellisenseProvider.cs）。编辑任意xsd:anyURI元素时，提示列表顶部会出现 "Browse..." 按钮，点击打开 WinFormsOpenFileDialog。其实现还做了相对路径友好处理（Builders.cs）：基于文档的BaseUri，把选中的绝对路径转换回相对 URI 写回 XML，保证文件移动后引用仍相对有效。

2. 颜色构建器（需显式声明）

XSD 没有标准颜色类型，因此必须通过vs:builder注解显式绑定XmlNotepad.ColorBuilder：

<xsd:simpleType name="color" vs:builder="XmlNotepad.ColorBuilder">

其中vs前缀绑定命名空间：

xmlns:vs="http://schemas.microsoft.com/Visual-Studio-Intellisense"

绑定后，编辑该类型值时提示列表顶部会出现 "Color Picker" 按钮，点击弹出 WinFormsColorDialog；选中的颜色通过ColorConverter序列化回 XML 字符串（Builders.cs）。

3. 第三方程序集中的构建器

如果自定义构建器/编辑器放在独立程序集中，还需要用vs:assembly指定程序集全名，例如：

<xsd:simpleType name="myType" vs:builder="MyNamespace.MyBuilder" vs:assembly="FontBuilder, Version=1.0.0.0, Culture=neutral, PublicKeyToken=007b972e7cff2ded, processorArchitecture=MSIL">

XML Notepad 加载该类型时，ConstructType（XmlIntellisenseProvider.cs）会先尝试类型缓存与内置类型解析，若失败则解析vs:assembly属性：优先在应用程序目录下查找同名单 DLL（Assembly.LoadFrom），否则按程序集全名Assembly.Load，再从程序集中取出指定类型并调用无参构造函数，实例会被缓存以保留用户状态。vs:builder、vs:editor、vs:assembly这些属性统称"Visual-Studio-Intellisense 注解"，由GetIntellisenseAttribute从 Schema 对象的UnhandledAttributes中按该命名空间读取（XmlIntellisenseProvider.cs）。

七、自己动手：实现 IXmlBuilder / IXmlEditor 扩展

两个扩展点接口定义在 IXmlBuilder.cs：

• IXmlBuilder（构建器）：Caption返回按钮标题；EditValue(owner, type, input, out output)负责弹出对话框，返回false表示用户取消。内置的ColorBuilder、UriBuilder都实现此接口；
• IXmlEditor（编辑器）：Editor返回实际编辑控件；XmlValue在编辑开始前注入当前值、编辑结束后回读新值。内置的DateTimeEditor实现此接口。

自定义类型无需额外注册文件：在 Schema 中把vs:builder/vs:editor属性值设为你的全限定类名（如MyCompany.MyBuilder），必要时配vs:assembly指向程序集即可。内置扩展的注册入口在 XmlTreeView.cs，通过IntellisenseProvider.RegisterBuilder/RegisterEditor写入类型缓存，供ConstructType复用。

八、把 Schema 接入编辑器

智能提示的前提是让 XML Notepad 知道你的 Schema。通过View → Schemas...打开 Schemas 对话框：右侧浏览按钮可逐个添加 XSD 文件，也可用 File 菜单的 "Add Files" 批量添加；第一列复选框可临时停用某个 Schema（停用后同时不参与校验与提示）；列表会持久化到XmlNotepad.settings，下次启动自动恢复。Schema 在磁盘上被修改后，SchemaCache会检测文件时间戳并自动重载（SchemaCache.cs），保证提示与最新 Schema 同步。

九、实现链路小结

把全文串起来，一次智能提示的完整生命周期是：

1. 位置感知：用户开始编辑名称/值时，TreeView.BeginEdit调用IntellisenseProvider.SetContextNode设置上下文节点；
2. 上下文计算：XmlIntellisenseProvider.OnContextChanged定位最近元素，构造Checker，并按OnNode/AfterNode/FirstChild位置调用XmlSchemaValidator获取期望粒子与属性（Checker.cs）；
3. 候选生成：名称提示走GetExpectedNames()（元素/属性 + 限定名 + 注解），取值提示走SchemaCache.GetExpectedValues()（枚举/列表/联合/内置类型）；
4. 扩展分发：编辑值前先解析vs:builder/vs:editor注解，命中则显示按钮或专用控件；
5. 交互呈现：TextEditorOverlay.BeginEdit把候选交给CompletionSet弹出下拉框，支持渐进匹配与 ENTER 确认。

这套"校验与提示共用同一 Schema"的架构，让开发者只需维护一份 XSD，即可同时获得验证错误报告与编辑期的语义级补全，是 XML Notepad 在复杂 XML 文档编辑场景下显著提升效率的核心机制。

关联阅读：自定义编辑器（Custom Editors） ｜ Schemas 对话框 ｜ 校验（Validation） ｜ 菜单与操作指南

• 桌面应用
• 开发工具