XamlXmlWriter Classe

Definição

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

public class XamlXmlWriter : System.Xaml.XamlWriter

type XamlXmlWriter = class
    inherit XamlWriter

Public Class XamlXmlWriter
Inherits XamlWriter

Herança

Object

XamlWriter

XamlXmlWriter

Observações

Esta classe é tipicamente usada em cenários de serialização.

Como usar o XamlXmlWriter

A XamlWriter API possui vários métodos que escrevem diferentes tipos de nós XAML. Coletivamente, estes são referidos na documentação como os Write métodos de um XamlWriter. XamlXmlWriter utiliza várias classes de estado internas para determinar o que fazer quando uma das suas Write implementações é chamada. Uma Write chamada utiliza os estados para determinar se o elemento, atributo ou valor solicitado pode ser escrito, ou se uma exceção é lançada. Por exemplo, se chamar WriteEndObject e o estado da XamlXmlWriter posição atual do nó estiver num valor ou dentro de um membro, é lançada uma exceção. Normalmente, os chamadores da XamlXmlWriter API devem estar atentos ao tipo do nó XAML atual que provém do leitor XAML e do fluxo de nós XAML. Com base neste conhecimento, os utilizadores devem evitar ligar Write APIs que não sejam relevantes para o tipo atual de nó.

Espaços de nomes XAML e XamlXmlWriter

O comportamento de escrita em espaços de nomes XAML de XamlXmlWriter é complexo e não se limita a chamadas explícitas para WriteNamespace. Em vez disso, outras Write chamadas, como WriteStartObject, podem exigir que a declaração do espaço de nomes seja escrita em pontos específicos da estrutura do nó. O escritor XAML ou gera um prefixo pela sua própria lógica, ou utiliza informação do INamespacePrefixLookup serviço para determinar um prefixo preferido. Além disso, chamadas explícitas WriteNamespace podem adiar ou não devolver nada se a declaração do espaço de nomes XAML já for aplicável e declarada noutro local.

Exceções de Método de Escrita

As exceções lançadas pelos XamlXmlWritermétodos são tipicamente ou WriteInvalidOperationException.XamlXmlWriterException

An InvalidOperationException indica frequentemente que um leitor XAML passou uma estrutura de nós inválida para o fluxo de nós XAML. Neste caso, a estrutura do nó é inválida por razões que não estão relacionadas com a validação de um esquema XAML ou de um contexto de esquema XAML. Antes, o fluxo de nós é inválido na sua forma básica. Por exemplo, se uma implementação defeituosa de leitor XAML gerasse um fluxo de nós XAML que continha dois nós consecutivos StartObject , a tentativa de chamar o segundo WriteStartObject lançaria um InvalidOperationException. Todos os escritores XAML considerariam tal operação inválida. Outro exemplo de um InvalidOperationException é quando a informação do namespace XAML não está disponível através do contexto do esquema XAML que se aplica à posição atual do fluxo de nós.

A XamlXmlWriterException indica uma exceção em que esta implementação específica de escritor XAML escolhe lançar uma exceção com base na sua funcionalidade pretendida. A XamlXmlWriterException pode indicar casos específicos em que o XamlXmlWriter A viola o seu próprio estado ou definições. Por exemplo, pode resultar XamlXmlWriterException de tentativas de escrever informação do espaço de nomes XAML numa posição que o XamlXmlWriter e o seu formato de serialização não suportam, ou de escrever membros duplicados quando as instâncias XamlXmlWriterSettings o proíbem.

Ver também

• Save(Stream, Object)
• Compreensão das Estruturas e Conceitos de Fluxos de Nós XAML