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 是唯一突出的实现。

请参见

概念

数据绑定概述

参考

绑定标记扩展

XmlDataProvider