Udostępnij za pośrednictwem

x:XData Wewnętrzny typ XAML

  • Artykuł

Umożliwia umieszczanie wysp danych XML w środowisku produkcyjnym XAML. Elementy XML w x:XData nie powinny być traktowane przez procesory XAML tak, jakby były częścią działającej domyślnej przestrzeni nazw XAML lub jakiejkolwiek innej przestrzeni nazw XAML. x:XData może zawierać dowolny poprawnie sformułowany kod XML.

Użycie elementu obiektu XAML

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

Wartości XAML

Wartość Opis
elementDataRoot Pojedynczy element główny otaczającej wyspy danych. W przypadku większości użytkowników ostatecznych kod XML, który nie ma jednego katalogu głównego, jest uznawany za nieprawidłowy. W szczególności pojedynczy katalog główny jest wymagany, jeśli x:XData jest przeznaczony jako źródło danych XML dla WPF lub wiele innych technologii, które używają źródeł XML do powiązania danych.
[elementData] Fakultatywny. Xml reprezentujący dane XML. Dowolna liczba elementów może być zawarta jako dane elementów, a zagnieżdżone elementy mogą być zawarte w innych elementach; obowiązują jednak ogólne reguły xml.

Uwagi

Elementy XML w obiekcie x:XData mogą ponownie zadeklarować wszystkie możliwe przestrzenie nazw i prefiksy zawierające element XMLDOM w danych.

Programowy dostęp do danych XML i x:XData wewnętrzny typ XAML jest możliwy w usługach XAML platformy .NET za pośrednictwem klasy XData.

Uwagi dotyczące użycia platformy WPF

Obiekt x:XData jest używany głównie jako obiekt podrzędny XmlDataProvider, lub alternatywnie, jako obiekt podrzędny właściwości XmlDataProvider.XmlSerializer (w języku XAML jest to zwykle wyrażane w składni elementu właściwości).

Dane powinny zwykle ponownie zdefiniować podstawową przestrzeń nazw XML na wyspie danych jako nową domyślną przestrzeń nazw XML (ustawioną na pusty ciąg). Jest to najłatwiejsze w przypadku prostych wysp danych, ponieważ wyrażenia XPath używane do odwołwania się i wiązania z danymi mogą uniknąć dołączania prefiksów. Bardziej złożone wyspy danych mogą definiować wiele prefiksów dla danych i używać określonego prefiksu dla przestrzeni nazw XML w katalogu głównym. W takim przypadku wszystkie odwołania do wyrażeń XPath powinny zawierać odpowiedni prefiks mapowany w przestrzeni nazw. Aby uzyskać więcej informacji, zobacz omówienie powiązania danych .

Technicznie można użyć x:XData jako zawartości dowolnej właściwości typu IXmlSerializable. Jednak XmlDataProvider.XmlSerializer jest jedyną znaczącą implementacją.

Zobacz też