x:XData XAML 指令元素
更新:2007 年 11 月
x:XData XAML 指令元素在 XAML 页内放置 XML 数据岛。此指令元素内的 XML 元素不会被视为 WPF 命名空间的一部分,并且可以包含任意格式良好的 XML。
XAML 对象元素用法
<XmlDataProvider ...>
<x:XData>
<elementDataRoot>
[elementData]
</elementDataRoot>
</x:XData>
</XmlDataProvider>
XAML 值
elementDataRoot |
必需。封闭的数据岛的单个根元素。如果没有单个根,则 x:XData 是无效的数据源。 |
[elementData] |
可选。表示数据的 XML。根据 XML 的通用规则,可以包含任意数目的元素作为元素数据,嵌套元素可以包含在其他元素中,等等。 |
依赖项
x:XData 元素主要用作 XmlDataProvider 的子级元素,或者用作以对象属性语法表示的 XmlDataProvider 属性的 XmlSerializer 属性的子级元素。
备注
此指令元素内的 XML 元素可以重新声明此数据岛内的所有可能的命名空间和前缀。通常,数据应将数据岛内的基 XML 命名空间重新定义为新的默认 XML 命名空间(设置为空字符串)。对于简单数据岛,这是最容易的方法,因为用于引用和绑定到数据的 XPath 表达式可以避免包含前缀。较为复杂的数据岛可能选择为数据定义多个前缀,并为根级别的 XML 命名空间使用一个特定的前缀。在这种情况下,所有 XPath 表达式引用都将需要包含相应的命名空间映射前缀。
通常,x:XData 可用作 IXmlSerializable 类型的任何属性的内容。但是,XmlDataProvider.XmlSerializer 是唯一突出的实现。