Visão geral da vinculação de dados do WPF com LINQ to XML

Artigo
06/02/2023

Este artigo apresenta os recursos de vinculação dinâmica de System.Xml.Linq dados no namespace. Esses recursos podem ser usados como uma fonte de dados para elementos de interface do usuário no WPF (Windows Presentation Foundation). Este cenário baseia-se em propriedades dinâmicas especiais do System.Xml.Linq.XAttribute e do System.Xml.Linq.XElement.

XAML e LINQ to XML

A linguagem XAML é um dialeto XML criado pela Microsoft para dar suporte a tecnologias do .NET. Ela é usada em WPF para representar elementos de interface do usuário e recursos relacionados, como associação de eventos e dados. No Windows Workflow Foundation, o XAML é usado para representar a estrutura do programa, como o controle de programa (fluxos de trabalho). O XAML permite que os aspectos declarativos de uma tecnologia sejam separados do código procedural relacionado que define o comportamento mais individualizado de um programa.

Há duas maneiras de o XAML e o LINQ to XML poderem interagir:

Como os arquivos XAML são XMLs bem-formados, podem ser consultados e manipulados pelas tecnologias XML como LINQ to XML.
Como as consultas LINQ to XML representam uma fonte de dados, elas podem ser usadas como uma fonte de dados para vinculação de dados para elementos de interface de usuário do WPF.

Esta documentação descreve o segundo cenário.

Vinculação de dados no Windows Presentation Foundation

A vinculação de dados do WPF permite que um elemento de interface de usuário associe uma de suas propriedades a uma fonte de dados. Um exemplo simples disso é um Label cujo texto apresenta o valor de uma propriedade pública em um objeto definido pelo usuário. A vinculação de dados do WPF depende dos seguintes componentes:

Componente	Descrição
Destino da associação	O elemento de interface do usuário a ser associado com a fonte de dados. Os elementos visuais no WPF são derivados da classe UIElement.
Propriedade de destino	A propriedade de dependência do destino da associação que reflete o valor da fonte da vinculação de dados. As propriedades de dependência têm suporte direto pela classe DependencyObject, da qual UIElement.
Origem de associação	O objeto de origem para um ou mais valores que são fornecidos para o elemento da interface de usuário para apresentação. O WPF oferece suporte automático aos seguintes tipos como fontes de associação: objetos CLR, objetos de dados ADO.NET, dados XML (de consultas XPath ou LINQ to XML) ou outro DependencyObject.
Caminho de origem	A propriedade da fonte de associação que resolve para o valor ou conjunto de valores que devem ser associados.

Uma propriedade de dependência é um conceito específico do WPF que representa uma propriedade dinamicamente computada de um elemento de interface do usuário. Por exemplo, as propriedades de dependência geralmente têm valores padrão ou valores que são fornecidos por um elemento pai. Essas propriedades especiais têm o suporte de instâncias da classe DependencyProperty (e não de campos com propriedades padrão). Para obter mais informações, consulte Visão geral sobre propriedades de dependência.

Vinculação dinâmica de dados no WPF

Por padrão, a vinculação de dados ocorre somente quando o elemento de interface do usuário de destino é inicializado. Isso é chamado de associação única. Para a maioria das finalidades, isso é insuficiente; normalmente, uma solução de vinculação de dados exige que as alterações sejam propagadas dinamicamente em tempo de execução usando um destes procedimentos:

A associação unidirecional faz as alterações em um lado serem propagadas automaticamente. Mais comumente, as alterações da origem são refletidas no destino, mas o inverso muitas vezes pode ser útil.
Na associação bidirecional, as alterações da origem são propagadas automaticamente para o destino, e as alterações para o destino são propagadas automaticamente para a origem.

Para que a associação unidirecional ou bidirecional ocorra, a origem deve implementar um mecanismo de notificação de mudança, por exemplo, implementando a interface de INotifyPropertyChanged ou usando um padrão PropertyNameChanged para cada propriedade com suporte.

Para obter mais informações sobre vinculação de dados no WPF, consulte Vinculação de dados (WPF).

Propriedades dinâmicas em classes LINQ to XML

A maioria das classes LINQ to XML não se qualificam como fontes de dados dinâmicos do WPF adequadas. Algumas das informações mais úteis estão disponíveis somente através de métodos, e não propriedades, e as propriedades nessas classes não implementam notificações de alteração. Para oferecer suporte à vinculação de dados do WPF, o LINQ to XML expõe um conjunto de propriedades dinâmicas.

Essas propriedades dinâmicas são as propriedades especiais em tempo de execução que duplicam a funcionalidade dos métodos existentes e as propriedades nas classes XAttribute e de XElement. Elas foram adicionados às classes exclusivamente para habilitá-las para atuar como fontes de dados dinâmicas para WPF. Para atender essa necessidade, todas essas propriedades dinâmicas implementam notificações de alterações. Uma referência detalhada sobre essas propriedades dinâmicas é fornecida na próxima seção, Propriedades dinâmicas LINQ to XML.

Observação

Muitas das propriedades públicas padrão, localizadas em várias classes no namespace System.Xml.Linq, podem ser usadas para a vinculação de dados única. No entanto, lembre-se de que nem a origem ou o destino serão atualizados dinamicamente neste esquema.

Acessar propriedades dinâmicas

As propriedades dinâmicas nas classes XAttribute e XElement não podem ser acessadas como propriedades padrão. Por exemplo, em linguagens compatíveis com CLR, como C#, elas não podem ser:

Acessadas diretamente em tempo de compilação. As propriedades dinâmicas são invisíveis para o compilador e o Visual Studio IntelliSense.
Descobertas ou acessadas em tempo de execução usando reflexão .NET. Mesmo em tempo de execução, elas não são propriedades no sentido básico de CLR.

No C#, as propriedades dinâmicas podem ser acessadas somente em tempo de execução através de recursos fornecidos pelo namespace System.ComponentModel.

Ao contrário, no entanto, em uma origem XML as propriedades dinâmicas podem ser acessadas através de uma notação simples da seguinte forma:

<object>.<dynamic-property>

As propriedades dinâmicas para essas duas classes resolvem para um valor que pode ser usado diretamente, ou para um indexador que deve ser fornecido com um índice para obter o valor resultante ou uma coleção de valores. A última sintaxe utiliza o formato:

<object>.<dynamic-property>[<index-value>]

Para obter mais informações, consulte Propriedades dinâmicas LINQ to XML.

Para implementar a associação dinâmica de WPF, as propriedades dinâmicas serão usadas com os recursos fornecidos pelo namespace System.Windows.Data, especialmente a classe Binding.

Compartilhar via