WPF-Samples 实战：使用 XmlDataSource 与 XPath 完成 XML 数据绑定

示例工程【免费下载链接】WPF-SamplesRepository for WPF related samples项目地址https://gitcode.com/gh_mirrors/wp/WPF-Samples点击查看免费下载本文以 WPF-Samples 仓库中的 XmlDataSource 示例 为主体系统讲解如何在 WPF 中使用XmlDataProvider将内嵌 XML 作为绑定数据源并通过 XPath 完成带条件的筛选查询与模板化呈现。读完本文你将掌握内联 XML 数据源的定义方式、XPath 属性过滤与并集|组合语法、{Binding XPath...}的绑定写法并能结合仓库中的兄弟示例XML 命名空间映射、外部 XML 文件、主从结构将其迁移到自己的项目中。示例概览它到底演示了什么该示例在仓库中的位置为 Data Binding/XmlDataSource其 README 明确定义了示例名称与用途“Binding Using XML Namespaces Sample”——演示如何处理 XML 绑定源中的命名空间并指向“在数据绑定中使用 XML 命名空间”的官方主题。从源码看它更完整的价值在于示范了一条“内联 XML XPath 过滤 DataTemplate 呈现”的完整数据绑定链路。整个示例由 4 个关键文件构成文件作用MainWindow.xaml核心演示定义XmlDataProvider、编写 XPath 查询、呈现列表MainWindow.cs仅承载InitializeComponent()的代码隐藏无额外逻辑App.xaml应用入口通过StartupUriMainWindow.xaml启动主窗口XmlDataSource.csprojSDK 风格项目文件目标框架为net10.0-windows启用 WPF其中MainWindow.cs没有任何业务代码见 MainWindow.cs说明本示例的全部技术含量都集中在 XAML 声明式绑定中——这也是 WPF 数据绑定的典型形态。用 XmlDataProvider x:XData 定义内联 XML 数据源示例的第一步是在StackPanel.Resources中声明一个XmlDataProvider并通过x:XData把 XML 数据直接内嵌到 XAML 里无需任何外部文件。完整代码如下节选自 MainWindow.xamlStackPanel.Resources XmlDataProvider x:KeyInventoryData XPathInventory/Books x:XData Inventory xmlns Books Book ISBN0-7356-0562-9 Stockin Number9 TitleXML in Action/Title SummaryXML Web Technology/Summary /Book Book ISBN0-7356-1370-2 Stockin Number8 TitleProgramming Microsoft Windows With C#/Title SummaryC# Programming using the .NET Framework/Summary /Book Book ISBN0-7356-1288-9 Stockout Number7 TitleInside C#/Title SummaryC# Language Programming/Summary /Book Book ISBN0-7356-1377-X Stockin Number5 TitleIntroducing Microsoft .NET/Title SummaryOverview of .NET Technology/Summary /Book Book ISBN0-7356-1448-2 Stockout Number4 TitleMicrosoft C# Language Specifications/Title SummaryThe C# language definition/Summary /Book /Books CDs CD Stockin Number3 TitleClassical Collection/Title SummaryClassical Music/Summary /CD CD Stockout Number9 TitleJazz Collection/Title SummaryJazz Music/Summary /CD /CDs /Inventory /x:XData /XmlDataProvider /StackPanel.Resources这里有几个值得注意的关键点XPathInventory/Books决定了数据源暴露的根节点。XmlDataProvider的XPath属性定义绑定集合的起点本例中它指向Inventory下的Books元素因此后续ListBox拿到的每一项都是Book元素。x:XData内嵌 XML 必须显式写xmlns来清空默认命名空间。这正是 README 标题中“XML NamespacesXML 命名空间”的落点WPF 的 XAML 解析器会把x:XData中的 XML 内容视为带有默认 XML 命名空间的文档若根元素不显式声明xmlns后续所有 XPath 查询都可能因为命名空间不匹配而查不到节点。这也是“在数据绑定中使用 XML 命名空间”的核心处理手段。数据同时包含属性和子元素两类形态ISBN、Stock、Number是Book元素的属性Title、Summary是子元素这为后面的 XPath 属性过滤提供了素材。同样的“内联 XML 数据源”写法在整个仓库的 Data Binding 目录中被反复使用例如 CollectionViewSource/MainWindow.xaml任务列表、Grouping/MainWindow.xaml按类型分组、CompositeCollections/MainWindow.xaml希腊英雄列表。它们都遵循同一套规范XmlDataProviderx:XData 根元素xmlns。XPath 查询属性过滤、数值比较与并集组合示例的核心看点在于ListBox的ItemsSource——它不是简单地把整个 Books 集合绑定上去而是用一段带条件的 XPath 筛选数据见 MainWindow.xamlListBox Width400 Height300 BackgroundHoneydew ListBox.ItemsSource Binding Source{StaticResource InventoryData} XPath*[Stockout] | *[Number8 or Number3]/ /ListBox.ItemsSource ... /ListBox这条 XPath 由三个知识点组成逐一拆解*通配符匹配Books节点下的任意子元素在本例即所有Book。[Stockout]属性条件只保留Stock属性值为out的书即缺货的《Inside C#》和《Microsoft C# Language Specifications》。*[Number8 or Number3]数值条件只保留Number属性值大于等于 8 或等于 3 的书。注意 XPath 对属性值会做类型推断Number在这里被当作数值比较而非字符串比较。|并集运算符把两个条件的结果取并集最终在ListBox中显示“缺货的书”与“数量大于等于 8 或等于 3 的书”的合集。这也是 XPath 中常用且容易忽略的语法点——两个筛选条件的节点集合并集用|连接。XAML 中声明式Binding元素写法XPath作为属性与标记扩展写法是等价的。示例源码随后用注释给出了等价形式但展示了 XPath 中特殊字符的转义问题见 MainWindow.xaml!--ListBox Width400 Height300 BackgroundHoneydew ItemsSource{Binding Source{StaticResource InventoryData}, XPath*[Stock\\out\] | *[Number\8 or Number\3]}--在{Binding ...}标记扩展内直接书写 XPath 时必须对和单引号做转义\、\、\否则 XAML 解析器会把它们当作标记扩展语法的一部分。因此更推荐声明式Binding元素写法它不需要任何转义可读性与可维护性都更好。从源码结构看这个筛选逻辑完全运行在数据提供层XmlDataProvider负责解析 XML 与执行XPathListBox只需消费结果集合业务代码MainWindow.cs保持为零这正体现了 WPF 声明式绑定的“数据驱动 UI”设计思想。用 Binding XPath 与 DataTemplate 呈现每一项筛选出符合条件的Book元素后还需要告诉ListBox每项如何显示。示例通过ItemTemplateDataTemplate完成见 MainWindow.xamlListBox.ItemTemplate DataTemplate TextBlock FontSize12 ForegroundRed TextBlock.Text Binding XPathTitle/ /TextBlock.Text /TextBlock /DataTemplate /ListBox.ItemTemplate要点在于当数据源是 XML 时Binding用XPath属性而非Path属性来定位字段。这里XPathTitle取当前Book元素的子元素Title的文本内容因此列表中每行显示的是书名红色 12 号字。若换成属性则应写作XPath属性名的形式。这一规则在仓库中体现得淋漓尽致Grouping/MainWindow.xaml 中Text{Binding XPathName}与Text{Binding XPathPriority}分别取 XML 元素的属性值CompositeCollections/MainWindow.xaml 中Text{Binding XPathName}取Hero的Name属性MasterDetailXml/MainWindow.xaml 中Text{Binding XPathname}取League的name属性。可见“XML 绑定用 XPath、CLR 对象绑定用 Path”是一条稳定的约定项目中两种写法并存且职责分明。延伸一外部 XML 文件作为数据源Source 属性XmlDataProvider的XPath除了配合x:XData使用也常与Source属性配合指向一个外部 XML 文件。仓库中的 MasterDetailXml 示例即采用这种方式见 MasterDetailXml/MainWindow.xamlXmlDataProvider x:KeyMyList SourceData\Leagues.xml XPathLeagues/League/对应的外部数据文件为 Data/leagues.xml其结构是一个三级层级Leagues xmlns League nameLeague A Division nameDivision A Team nameTeam I/ ...该示例使用三个同步ListBox展示层级数据第一个ListBox绑定Leagues/League第二个绑定所选League下的Division第三个绑定所选Division下的Team见 MasterDetailXml/MainWindow.xaml并借助IsSynchronizedWithCurrentItemtrue与{Binding ElementNamedivisionsListBox, PathSelectedItem}实现主从联动。这与本示例形成了完整互补内联 XML 适合演示与原型外部 XML 文件适合真实数据而XmlDataProvider对两者的用法一致。延伸二XML 命名空间的映射与查询XmlNamespaceMappingCollectionREADME 标题点名的“XML Namespaces”问题在 XmlnsBind 示例中有更完整的落地方案。当 XML 数据本身带有真实命名空间例如 RSS 订阅源时仅靠xmlns清空默认命名空间是不够的还需要把命名空间 URI 映射为可查询的前缀见 XmlnsBind/MainWindow.xamlXmlNamespaceMappingCollection x:KeyMapping XmlNamespaceMapping Urihttp://purl.org/dc/elements/1.1/ Prefixdc / /XmlNamespaceMappingCollection XmlDataProvider Sourcehttp://msdn.microsoft.com/subscriptions/rss.xml XmlNamespaceManager{StaticResource Mapping} XPathrss/channel/item x:KeyProvider/随后在DataTemplate中即可用映射出的前缀进行 XPath 查询见 XmlnsBind/MainWindow.xamlTextBlock Grid.Row0 Text{Binding XPathtitle} / TextBlock Grid.Row1 Text{Binding XPathdc:date} /通过XmlNamespaceMappingCollection声明Uri → Prefix映射再把它赋给XmlDataProvider.XmlNamespaceManagerXPath 表达式就能使用dc:这类前缀访问带命名空间的节点。结合本示例的xmlns技巧可以形成处理 XML 命名空间的完整知识闭环内联数据无命名空间需求根元素声明xmlnsXPath 保持简洁外部数据带真实命名空间用XmlNamespaceMappingCollection建立前缀映射让 XPath 可寻址。延伸三与 CollectionViewSource、分组、复合集合的协同XmlDataProvider产生的集合同样可以接入 WPF 的视图与组织机制CollectionViewSource/MainWindow.xaml 直接把XmlDataProvider作为CollectionViewSource的Source并对其施加排序与分组SortDescription PropertyNamePriority、PropertyGroupDescription PropertyNamePriority说明属性名前加的 XPath 约定同样适用于 CollectionViewSource 的排序/分组描述。Grouping/MainWindow.xaml 将XmlDataProvider绑定到ItemsControl再通过GroupStyle按任务类型分组展示。CompositeCollections/MainWindow.xaml 通过CollectionContainer把XmlDataProvider集合与 CLR 对象集合组合进同一个CompositeCollection验证了 XML 集合与其他集合类型的混排能力。这些示例说明XmlDataProvider输出的集合与普通 CLR 集合在使用上基本一致可以自由进入CollectionViewSource、ItemsControl等基础设施。构建与运行示例按照 README 中的说明在 Visual Studio 2022 中打开示例后构建选择Build生成→ Deploy Solution部署解决方案完成构建与部署。调试运行按F5或选择Debug调试→ Start Debugging开始调试。非调试运行按CtrlF5或选择Debug调试→ Start Without Debugging开始不调试而运行。示例项目本身是 SDK 风格见 XmlDataSource.csproj设置UseWpftrue且目标框架为net10.0-windowsOutputTypeWinExe属于可直接编译运行的标准 WPF 桌面应用。小结XmlDataSource 示例虽短却浓缩了 WPF XML 数据绑定的四条核心技能数据源定义XmlDataProviderx:XData内联 XML根元素用xmlns清空默认命名空间筛选查询用 XPath 的属性条件Stockout、数值比较Number8与并集|在数据层完成过滤模板呈现DataTemplate内用Binding XPathTitle取子元素、Binding XPathattr取属性边界处理外部带命名空间的 XML 用XmlNamespaceMappingCollection做前缀映射。在 WPF-Samples 仓库中XmlDataSource、MasterDetailXml、XmlnsBind、Grouping 等示例互相印证构成了从内联 XML、外部 XML、命名空间映射到主从联动的完整实践谱系可直接作为你项目中的数据绑定参考蓝本。赞分享示例工程【免费下载链接】WPF-SamplesRepository for WPF related samples项目地址https://gitcode.com/gh_mirrors/wp/WPF-Samples点击查看免费下载相关推荐WPF-Samples 复合集合数据绑定实战用 CompositeCollection 与 CollectionContainer 混合绑定多类型数据源WPF Samples 复合集合数据绑定实战用 CompositeCollection 与 CollectionContainer 混合绑定多类型数据源 本指示例工程WPF 层级数据绑定实战深入解析 WPF-Samples 的 HierarchicalDataTemplate 示例WPF 层级数据绑定实战深入解析 WPF Samples 的 HierarchicalDataTemplate 示例 导读 在 WPF 开发中列表里嵌套列示例工程WPF-Samples 实战用 INotifyPropertyChanged 实现数据绑定属性变更通知WPF Samples 实战用 INotifyPropertyChanged 实现数据绑定属性变更通知 本文以 WPF Samples 仓库中的 Proper示例工程上一篇Deep Lake数据分片与路由优化分布式查询性能下一篇Symfony YAML命令行工具实战yaml-lint快速检测和修复YAML语法错误创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考