Share via


Amostra de associação de dados do LINQ to XML

Este artigo descreve o exemplo LinqToXmlDataBinding, um aplicativo Windows Presentation Foundation (WPF) que vincula componentes de interface do usuário a uma fonte de dados XML incorporada.

Visão geral

O exemplo LinqToXmlDataBinding é um aplicativo do Windows Presentation Foundation (WPF) que contém arquivos de origem C# e XAML. Um documento XML incorporado define uma lista de livros. O aplicativo permite que o usuário visualize, adicione, exclua e edite as entradas do livro.

Há dois arquivos de origem primários:

  • L2DBForm.xaml contém o código de declaração XAML para a interface do usuário da janela principal. Ele também contém uma seção de recursos de janela que define um provedor de dados e um documento XML incorporado para as listagens de livros.

  • L2DBForm.xaml.cs contém os métodos de inicialização e de manipulação de eventos associados à interface do usuário.

A janela principal é dividida nas quatro seções verticais de interface de usuário:

  • XML exibe o código-fonte XML bruto da listagem de livros inserida.

  • Lista de livros exibe as entradas de livro como texto padrão e permite que o usuário selecione e exclua entradas individuais.

  • Editar Livro Selecionado permite que o usuário edite os valores associados à entrada do livro selecionada no momento.

  • Adicionar Novo Livro habilita a criação de uma nova entrada de livro com base nos valores inseridos pelo usuário.

Execute o exemplo

Esta seção mostra como criar e compilar o projeto LinqToXmlDataBinding no Visual Studio e como executar o aplicativo LinqToXmlDataBinding Windows Presentation Foundation (WPF) resultante.

Criar o projeto

  1. Inicie o Visual Studio e crie um WPF App em C# chamado LinqToXmlDataBinding.

    O projeto deve direcionar o .NET Framework 3.5 (ou posterior).

  2. Se ainda não presentes, adicione referências de projeto para os seguintes conjuntos de módulos (assemblies) .NET:

    • System.Data
    • System.Data.DataSetExtensions
    • System.Xml
    • System.Xml
  3. Crie a solução pressionando Ctrl+Shift+B e execute-a pressionando F5.

    O projeto deve compilar sem erros e como executar um aplicativo genérica de WPF.

Incluir código

  1. No Gerenciador de Soluções, renomeie o arquivo de origem Window1.xaml como L2XDBForm.xaml.

    O arquivo de origem dependente Window1.xaml.cs é renomeado automaticamente para L2XDBForm.xaml.cs.

  2. Substitua o código-fonte encontrado no arquivo L2XDBForm.xaml pelo código-fonte L2DBForm.xaml. Use o modo de exibição XAML para trabalhar com esse arquivo.

  3. Da mesma forma, substitua a origem em L2XDBForm.xaml.cs pelo código-fonte L2DBForm.xaml.cs código-fonte.

  4. No arquivo App.xaml, substitua todas as ocorrências da cadeia de caracteres Window1.xaml por L2XDBForm.xaml.

  5. Crie a solução ao pressionar Ctrl+Shift+B.

Executar o aplicativo

O aplicativo LinqToXmlDataBinding permite que o usuário exiba e manipule uma lista de livros armazenados como um elemento XML incorporado. Execute o aplicativo pressionando F5 (Iniciar Depuração) ou Ctrl+F5 (Iniciar Sem Depuração).

É exibida uma janela de programa com o título Associação de dados do WPF usando LINQ to XML.

A seção superior da interface do usuário exibe o XML bruto que representa a lista de livros. É exibida usando um controle de TextBlock WPF, que não permite a interação por meio do mouse ou do teclado.

A segunda seção vertical, rotulada como Lista de livros, exibe os livros como uma lista ordenada de texto sem formatação. Usa um controle de ListBox que permite a seleção embora o mouse ou o teclado.

Adicionar e excluir livros

Para adicionar um novo livro à lista, insira valores nos controles ID e ValorTextBox na última seção, Adicionar Novo Livro e selecione Adicionar Livro. O livro é anexado à lista nas listagens do livro e XML. Este programa não validar valores de entrada.

Para excluir um livro existente da lista, selecione-o na seção Lista de Livros e selecione Remover Livro Selecionado. A entrada do livro é removida das listagens de código-fonte XML bruto e do livro.

Editar uma entrada de livro

  1. Selecione a entrada de livro na segunda seção da Lista de livros.

    Seus valores atuais são exibidos na seção Editar Livro Selecionado.

  2. Editar os valores usando o teclado. Assim que qualquer um dos TextBox controles perde o foco, as alterações são propagadas automaticamente para as listagens de código-fonte XML e livro.