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

Comentários

Essa classe normalmente é usada em cenários de serialização.

Como usar o XamlXmlWriter

A XamlWriter API tem vários métodos que gravam diferentes tipos de nós XAML. Coletivamente, eles são referidos na documentação como os Write métodos de um XamlWriter. XamlXmlWriter usa várias classes de estado internas para determinar o que fazer quando uma de suas Write implementações é chamada. Uma Write chamada usa os estados para determinar se o elemento, atributo ou valor solicitado pode ser gravado ou se uma exceção é gerada. Por exemplo, se você chamar WriteEndObject e o estado da posição atual do XamlXmlWriter nó estiver em um valor ou dentro de um membro, uma exceção será gerada. Normalmente, os XamlXmlWriter chamadores da API devem estar cientes do tipo do nó XAML atual que vem do leitor XAML e do fluxo de nós XAML. Com base nesse conhecimento, os chamadores devem evitar chamar Write APIs que não são relevantes para o tipo de nó atual.

Namespaces XAML e XamlXmlWriter

O comportamento de gravação do XamlXmlWriter namespace XAML é 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 de namespace seja gravada em pontos específicos na estrutura do nó. O gravador XAML gera um prefixo por sua própria lógica ou usa informações do INamespacePrefixLookup serviço para determinar um prefixo preferencial. Além disso, chamadas explícitas WriteNamespace podem adiar ou não retornarão nada se a declaração de namespace XAML já for aplicável e declarada em outro lugar.

Exceções do método Write

As exceções geradas pelos XamlXmlWriterWrite métodos normalmente são ou InvalidOperationExceptionXamlXmlWriterException.

Geralmente InvalidOperationException , um leitor de XAML passou uma estrutura de nó inválida para o fluxo de nós XAML. Nesse caso, a estrutura do nó é inválida por motivos que não estão relacionados à validação de um esquema XAML ou a um contexto de esquema XAML. Em vez disso, o fluxo de nó é inválido em sua forma básica. Por exemplo, se uma implementação de leitor XAML com falha gerasse um fluxo de nó XAML que continha dois nós consecutivos StartObject , a tentativa de chamar o segundo WriteStartObject geraria um InvalidOperationException. Todos os gravadores XAML considerariam essa operação inválida. Outro exemplo de um InvalidOperationException é quando as informações de namespace XAML não estão disponíveis por meio do contexto de esquema XAML que se aplica à posição atual do fluxo de nó.

Uma XamlXmlWriterException indica uma exceção em que essa implementação de gravador XAML específica opta por lançar uma exceção com base em sua funcionalidade pretendida. Uma XamlXmlWriterException pode indicar casos específicos em que um XamlXmlWriter viola seu próprio estado ou configurações. Por exemplo, um XamlXmlWriterException pode resultar de tentativas de gravar informações de namespace XAML em uma posição que o XamlXmlWriter formato de serialização e seu formato de serialização não dão suporte ou gravação de membros duplicados quando a instância o XamlXmlWriterSettings proíbe.

Confira também

• Save(Stream, Object)
• Noções básicas sobre estruturas e conceitos de fluxo de nó XAML