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 API XamlWriter tem vários métodos que gravam diferentes tipos de nós XAML. Coletivamente, eles são referidos na documentação como os métodos Write de um XamlWriter. XamlXmlWriter usa várias classes de estado internas para determinar o que fazer quando uma de suas implementações de Write é chamada. Uma chamada Write 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 do XamlXmlWriter posição do nó atual estiver em um valor ou dentro de um membro, uma exceção será gerada. Normalmente, os chamadores da API de XamlXmlWriter 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 APIs Write que não são relevantes para o tipo de nó atual.

Namespaces XAML e XamlXmlWriter

O comportamento de gravação do namespace XAML de XamlXmlWriter é complexo e não se limita a chamadas explícitas para WriteNamespace. Em vez disso, outras chamadas Write, como WriteStartObject, podem exigir que a declaração de namespace seja gravada em pontos específicos da estrutura do nó. O gravador XAML gera um prefixo por sua própria lógica ou usa informações do serviço INamespacePrefixLookup para determinar um prefixo preferencial. Além disso, chamadas WriteNamespace explícitas podem adiar ou não retornar 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 métodos XamlXmlWriterWrite normalmente são InvalidOperationException ou XamlXmlWriterException.

Um InvalidOperationException geralmente indica que 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 gerou um fluxo de nó XAML que continha dois nós StartObject consecutivos, a tentativa de chamar o segundo WriteStartObject lançaria 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ó.

Um XamlXmlWriterException indica uma exceção em que essa implementação específica do gravador XAML opta por lançar uma exceção com base em sua funcionalidade pretendida. Um 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 e seu formato de serialização não dão suporte ou gravar membros duplicados quando o XamlXmlWriterSettings proibi-lo da instância.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

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