Поделиться через


Элемент директивы XAML x:XData

Обновлен: Ноябрь 2007

Элемент директивы x:XData XAML размещает острова данных XML на странице XAML. Элементы XML внутри данного элемента директивы не рассматриваются как принадлежащие пространству имен WPF и могут содержать произвольные элементы XML в правильном формате.

Использование элемента объекта XAML

<XmlDataProvider ...>
  <x:XData>
    <elementDataRoot>
      [elementData]
    </elementDataRoot>
  </x:XData>
</XmlDataProvider>

Значения XAML

elementDataRoot

Необходимый параметр. Один корневой элемент вложенного острова данных. Без одного корневого элемента x:XData нельзя использовать в качестве источника данных.

[elementData]

Дополнительный параметр. XML, представляющий данные. Любое число элементов может обрабатываться как элемент данных, вложенные элементы могут содержаться в других элементах и т. д., в соответствии с общими правилами XML.

Зависимости

Элемент x:XData в главным образом используется как дочерний элемент XmlDataProvider, или как дочерний элемент свойства XmlSerializer свойства XmlDataProvider, выраженного в синтаксисе свойства объекта.

Заметки

Элементы XML внутри этого элемента директивы могут повторно объявлять все возможные пространства имен и префиксы в пределах острова данных. Как правило, данные должны переопределять базовый XML-код в острове данных таким образом, чтобы он стал новым XML-кодом по умолчанию (присваивается пустая строка). Это легче всего осуществить с островами простых данных, поскольку выражения XPath, используемые для ссылки и привязки к данным, могут использоваться без префиксов. В более сложных островах данных можно определить несколько префиксов для данных или использовать специальный префикс для пространства имен XML в корневом элементе. В этом случае все ссылки выражения XPath должны включать соответствующий префикс пространства имен.

С технической точки зрения x:XData можно использовать как содержимое любого свойства типа IXmlSerializable. Однако, XmlDataProvider.XmlSerializer является единственной значимой реализацией.

См. также

Основные понятия

Общие сведения о связывании данных

Ссылки

Привязка расширения разметки

XmlDataProvider