XamlObjectWriter Classe

Definição

public ref class XamlObjectWriter : System::Xaml::XamlWriter, System::Xaml::IXamlLineInfoConsumer

public class XamlObjectWriter : System.Xaml.XamlWriter, System.Xaml.IXamlLineInfoConsumer

type XamlObjectWriter = class
    inherit XamlWriter
    interface IXamlLineInfoConsumer

Public Class XamlObjectWriter
Inherits XamlWriter
Implements IXamlLineInfoConsumer

Herança

Object

XamlWriter

XamlObjectWriter

Implementações

IXamlLineInfoConsumer

Observações

Os métodos para Write implementar um padrão de modo que o XamlObjectWriter use o XamlObjectWriter que é definido pelo XamlWriter método.WriteNode WriteNode A lógica alterna entre os Write métodos, dependendo do tipo de nó que está na posição atual no leitor.

Scope

A tem um conceito de âmbito; ou seja, mantém XamlObjectWriter um ponto conceptual de referência no seu grafo XamlObjectWriter de objeto de saída. Para um âmbito específico, certas operações podem ser válidas ou inválidas, ou produzir um resultado sem operação. Por exemplo, se chamar WriteStartMember para escrever diretivas para inicialização num objeto que já existe como instância, a implementação padrão lança uma exceção.

Uma técnica possível para acompanhar o âmbito num custom XamlObjectWriter é alinhar as ações do nó com uma stack ou classe de frame. A pilha ou frame pode registar o push e o pop para cada nível de profundidade do modelo de objeto que é introduzido ou retirado enquanto escreve XamlObjectWriter o grafo de objetos.

Chamadas de retorno

Para suportar cenários intermédios e avançados XamlObjectWriter , o mecanismo de escrever um grafo de objeto fornece pontos de entrada de callback que ocorrem quando um XamlObjectWriter commit ou está prestes a cometer certas ações. Alguns callbacks estão ativados nas definições e não são específicos do tipo de objeto ou do membro que está a ser escrito; no entanto, a informação de callback está frequentemente disponível em contexto ou está nos dados do evento enviados através do callback. Segue-se uma lista de callbacks relevantes:

• O callback declarado por AfterBeginInitHandler é invocado quando o âmbito passa para um novo objeto e na BeginInit fase de vida útil do objeto para cada objeto criado.

• O callback declarado por AfterEndInitHandler é invocado quando o âmbito passa para um novo objeto e na EndInit fase de vida útil do objeto para cada objeto criado.

• O callback declarado por BeforePropertiesHandler é invocado quando o âmbito começa num objeto, e ocorre quando a primeira WriteStartMember chamada a esse âmbito é feita mas ainda não foi comprometida.

• O callback que é declarado AfterPropertiesHandler por é invocado quando o âmbito começa num objeto, e ocorre quando a WriteEndObject chamada para esse âmbito é feita mas ainda não foi confirmada.

• O callback declarado por XamlSetValueHandler é invocado quando OnSetValue é chamado.

Escrita de Chaves de Dicionário

A implementação padrão de XamlObjectWriter suporta a conversão de tipos nas restrições de a Dictionary<TKey,TValue> antes de o conteúdo do dicionário ser adicionado ao grafo objeto. Desta forma, um dicionário genérico pode ser codificado em tempo de execução por objetos e pode corresponder ao comportamento genérico Add e do indexador relevante. No entanto, como implementado para a base XamlObjectWriter, esta capacidade existe apenas para a criação de grafos de objetos a partir da classe base Dictionary<TKey,TValue> e não para classes derivadas de Dictionary<TKey,TValue>.

Cheques para Descartados

Os escritores XAML são potencialmente usados para operações diferidas ou quando uma chamada é feita contra uma instância de escritor XAML que foi eliminada entretanto. Várias APIs podem XamlObjectWriter incluir ObjectDisposedException estes casos.

Ver também

• XamlWriter
• XamlObjectReader