XamlObjectWriter.WriteGetObject Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava o conceitual StartObject no grafo de objeto quando o objeto especificado é um valor padrão ou implícito da propriedade pai. O valor implícito vem de informações obtidas do contexto do esquema XAML e das informações de tipo de backup, em vez de serem especificadas como um valor de objeto no conjunto de nós XAML de entrada.
public:
override void WriteGetObject();
public override void WriteGetObject();
override this.WriteGetObject : unit -> unit
Public Overrides Sub WriteGetObject ()
Comentários
A diferença entre escrever com WriteGetObject e gravar com WriteStartObject pode ser vista no grafo de objeto resultante. WriteGetObject não constrói uma instância de um tipo porque a WriteGetObject API não tem informações para informar o grafo de objeto do que construir. Em vez disso, o objeto foi criado quando a propriedade pai foi inicializada; portanto, XamlObjectWriter não é necessário construí-lo. Por outro lado, WriteStartObject especifica que uma instância desse tipo deve ser construída e inserida no grafo de objeto.
Se você pensar no fluxo de nós XAML como uma série de quadros, será WriteGetObject balanceado para uma WriteEndObject chamada. Portanto, o número de WriteGetObject chamadas de adição WriteStartObject deve ser igual ao número de WriteEndObject chamadas como parte de uma avaliação completa de gravação de objeto do fluxo de nós XAML.
A posição conceitual StartObject de um objeto implícito no grafo de objeto é necessária porque, embora o valor do objeto em si seja um padrão implícito, esse objeto ainda pode ter membros que precisam ser gravados com base no fluxo de nós XAML. Um cenário típico em que isso ocorre é quando XamlObjectWriter grava nós de membro para uma propriedade de coleção e a inicialização da coleção está implícita para criar o objeto que possui a propriedade da coleção.