XamlXmlWriter Класс

Определение

public ref class XamlXmlWriter : System::Xaml::XamlWriter

public class XamlXmlWriter : System.Xaml.XamlWriter

type XamlXmlWriter = class
    inherit XamlWriter

Public Class XamlXmlWriter
Inherits XamlWriter

Наследование

Object

XamlWriter

XamlXmlWriter

Комментарии

Этот класс обычно используется в сценариях сериализации.

Использование XamlXmlWriter

API XamlWriter имеет несколько методов, которые записывают различные типы узлов XAML. В совокупности эти методы называются в XamlWriterдокументацииWrite. XamlXmlWriter использует несколько внутренних классов состояний, чтобы определить, что делать при вызове одной из его Write реализаций. Вызов Write использует состояния, чтобы определить, можно ли записать запрошенный элемент, атрибут или значение, или создать исключение. Например, при вызове WriteEndObject и состоянии текущего XamlXmlWriter положения узла возникает исключение. Как правило, вызывающие XamlXmlWriter API должны учитывать тип текущего узла XAML, исходящего из средства чтения XAML и потока узлов XAML. На основе этих знаний вызывающие элементы должны избегать вызовов Write API, которые не относятся к текущему типу узла.

Пространства имен XAML и XamlXmlWriter

Поведение XamlXmlWriter записи пространства имен XAML является сложным и не ограничивается явными вызовами WriteNamespace. Вместо этого другие Write вызовы, например WriteStartObject, могут потребовать, чтобы объявление пространства имен записывали в определенных точках в структуре узла. Модуль записи XAML либо создает префикс по собственной логике, либо использует сведения из INamespacePrefixLookup службы для определения предпочтительного префикса. Кроме того, явные WriteNamespace вызовы могут отложить или ничего не возвращать, если объявление пространства имен XAML уже применимо и объявлено в другом месте.

Исключения методов записи

Исключения, создаваемые XamlXmlWriterWrite методами, InvalidOperationException обычно являются либо XamlXmlWriterException.

Часто InvalidOperationException указывает, что средство чтения XAML передало недопустимую структуру узлов в поток узлов XAML. В этом случае структура узла является недопустимой по причинам, которые не связаны с проверкой схемы XAML или контекстом схемы XAML. Скорее, поток узлов недопустим в базовой форме. Например, если неисправная реализация средства чтения XAML создала поток узлов XAML, содержащий два последовательных StartObject узла, попытка вызвать второй WriteStartObject вызов вызовет ошибку InvalidOperationException. Все записи XAML считают, что такая операция является недопустимой. Еще одним примером InvalidOperationException является то, что сведения о пространстве имен XAML недоступны через контекст схемы XAML, который применяется к текущей позиции потока узлов.

Указывает XamlXmlWriterException исключение, в котором эта конкретная реализация модуля записи XAML выбирает исключение на основе его предполагаемой функциональности. Может XamlXmlWriterException указывать конкретные случаи XamlXmlWriter нарушения собственного состояния или параметров. Например, XamlXmlWriterException может привести к попыткам записи сведений о пространстве имен XAML в положение, которое XamlXmlWriter не поддерживается и его формат сериализации, или запись повторяющихся элементов при запрете экземпляра XamlXmlWriterSettings .

См. также раздел

• Save(Stream, Object)
• Общие сведения о структурах и концепциях потоков узлов XAML