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

Artigo
06/19/2015

Este tópico apresenta os recursos dinâmicos de vinculação de dados no namespace System.Xml.Linq. Esses recursos podem ser usados como uma fonte de dados para elementos de interface do usuário no Windows Presentation Foundation (WPF).

XAML e LINQ to XML

A linguagem XAML é um dialeto XML criado pela Microsoft para dar suporte a tecnologias do .NET Framework 3.0. 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 de 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.
Fonte 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 de propriedades da dependência.

Associaçã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 mais informações sobre vinculação de dados no WPF, consulte Associação de dados (WPF).

Propriedades dinâmicas nas classes LINQ to XML

A maioria de classes LINQ to XML não são qualificadas como fontes de dados dinâmicas adequadas do WPF: algumas das informações mais úteis está disponível somente através de métodos (e não propriedades), e as propriedades nessas classes não implementam as 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, LINQ te o propriedades dinâmicas de XML.

Dica

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.

Acessando 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 LINQ te o propriedades dinâmicas de 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.