Demonstra Passo a passo: Leitura de dados XML em um Dataset.

Artigo
08/01/2011

ADO.NET fornece métodos simples para trabalhar com dados XML. Nesta explicação passo a passo você criará um aplicativo do Windows que irá carregar dados XML em um DataSet. The dataset will then be displayed in a DataGridView. Finally, an XML Schema based on the contents of the XML file will be displayed in a text box.

Este explicação passo a passo consiste das cinco etapas principais:

Criando um novo projeto.
Criar um arquivo XML a ser lido no DataSet.
Criando a interface do usuário.
Creating the dataset, read the XML file, and display it in a DataGridView control.
Adding code to display the XML Schema based on the XML file in a TextBox control.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Criar um novo projeto

Nesta etapa, você irá criar um projeto de Visual Basic ou C# Visual que irá conter esta explicação passo a passo.

Para criar o novo projeto Windows

No menu File, crie um novo projeto.
Nomeie o projeto ReadingXML.
Selecione Windows Application e clique em OK. Para obter mais informações, consulte Criando Aplicativos Baseados no Windows.

O projeto ReadingXML é criado e adicionado no Solution Explorer.

Gere o arquivo XML a ser lido para o DataSet

Porque esta explicação passo a passo enfoca leitura de dados XML em um DataSet, o conteúdo de um arquivo XML é fornecido.

Para criar o arquivo XML que será lido para o DataSet

No menu Project, escolha Add New Item.
Selecione XML File, nomeie o arquivo authors.xml, e clique em Add.

O arquivo XML carrega no designer e está pronto para edição.

Cole o seguinte código no editor abaixo da declaração XML:

<Authors_Table>
  <authors>
    <au_id>172-32-1176</au_id>
    <au_lname>White</au_lname>
    <au_fname>Johnson</au_fname>
    <phone>408 496-7223</phone>
    <address>10932 Bigge Rd.</address>
    <city>Menlo Park</city>
    <state>CA</state>
    <zip>94025</zip>
    <contract>true</contract>
  </authors>
  <authors>
    <au_id>213-46-8915</au_id>
    <au_lname>Green</au_lname>
    <au_fname>Margie</au_fname>
    <phone>415 986-7020</phone>
    <address>309 63rd St. #411</address>
    <city>Oakland</city>
    <state>CA</state>
    <zip>94618</zip>
    <contract>true</contract>
  </authors>
  <authors>
    <au_id>238-95-7766</au_id>
    <au_lname>Carson</au_lname>
    <au_fname>Cheryl</au_fname>
    <phone>415 548-7723</phone>
    <address>589 Darwin Ln.</address>
    <city>Berkeley</city>
    <state>CA</state>
    <zip>94705</zip>
    <contract>true</contract>
  </authors>
  <authors>
    <au_id>267-41-2394</au_id>
    <au_lname>Hunter</au_lname>
    <au_fname>Anne</au_fname>
    <phone>408 286-2428</phone>
    <address>22 Cleveland Av. #14</address>
    <city>San Jose</city>
    <state>CA</state>
    <zip>95128</zip>
    <contract>true</contract>
  </authors>
  <authors>
    <au_id>274-80-9391</au_id>
    <au_lname>Straight</au_lname>
    <au_fname>Dean</au_fname>
    <phone>415 834-2919</phone>
    <address>5420 College Av.</address>
    <city>Oakland</city>
    <state>CA</state>
    <zip>94609</zip>
    <contract>true</contract>
  </authors>
</Authors_Table>

No menu File, aponte para Save authors.xml.

Crie a interface de usuário

A interface do usuário para este aplicativo consistirá do seguinte:

A DataGridView control that will display the contents of the XML file as data.
A TextBox control that will display the XML Schema for the XML file.
Dois controles Button.
- One button reads the XML file into the dataset and displays it in the DataGridView control.
- A second button extracts the schema from the dataset, and through a StringWriter displays it in the TextBox control.

Para adicionar controles ao formulário

Open Form1 in design view.
No Toolbox, arraste os seguintes controles no formulário:
- One DataGridView control
- One TextBox control
- Two Button controls

Defina as seguintes propriedades:

Controle	Propriedade	Configuração
TextBox1	Multiline (de múltiplas linhas)	true
	ScrollBars	Vertical
Button1	Nome	ReadXmlButton
	Texto	Read XML
Button2	Nome	ShowSchemaButton
	Texto	Show Schema

Crie o DataSet que irá receber os dados XML

In this next procedure, you create a new dataset named authors. For more information about datasets, see Trabalhando com conjuntos de dados Visual Studio.

Para criar um novo DataSet que receberá os dados XML

Com o arquivo fonte para Form1 selecionado em Solution Explorer, clique no botão View Designer na barra de ferramentas Solution Explorer.
From the Guia de dados, caixa de ferramentas, drag a DataSet onto Form1.
Select Untyped dataset on the Caixa de Diálogo Add Dataset, and then click OK.

DataSet1 é adicionado à bandeja do componente.
In the Properties window, set the Name and DataSetName properties to AuthorsDataSet.

Crie o manipulador de eventos para ler o XML para o DataSet

The Read XML button reads the XML file into the dataset and sets properties on the DataGridView control that bind it to the dataset.

Para adicionar código ao manipulador de eventos ReadXmlButton_Click

No Solution Explorer, selecione Form1 e clique no View Designer botão da barra de ferramentas Solution Explorer.
Clique duas vezes no botão Read XML.

The Code Editor opens at the ReadXmlButton_Click event handler.

Type the following code into the ReadXmlButton_Click event handler:

Private Sub ReadXmlButton_Click() Handles ReadXmlButton.Click

    Dim filePath As String = "Complete path where you saved the XML file"

    AuthorsDataSet.ReadXml(filePath)

    DataGridView1.DataSource = AuthorsDataSet
    DataGridView1.DataMember = "authors"
End Sub

private void ReadXmlButton_Click(object sender, EventArgs e)
{
    string filePath = "Complete path where you saved the XML file";

    AuthorsDataSet.ReadXml(filePath);

    dataGridView1.DataSource = AuthorsDataSet;
    dataGridView1.DataMember = "authors";
}

In the ReadXMLButton_Click event handler code, change the filepath = entry to the correct path.

Crie o manipulador de eventos para exibir o esquema na Textbox

The Show Schema button creates a StringWriter object that is filled with the schema and displayed in the TextBox .

Para adicionar código ao manipulador de eventos ShowSchemaButton_Click

No Solution Explorer, selecione Form1 e clique no botão View Designer.
Clique duas vezes no botão Show Schema.

The Code Editor opens at the ShowSchemaButton_Click event handler.

Type the following code into the ShowSchemaButton_Click event handler.

Private Sub ShowSchemaButton_Click() Handles ShowSchemaButton.Click

    Dim swXML As New System.IO.StringWriter()
    AuthorsDataSet.WriteXmlSchema(swXML)
    TextBox1.Text = swXML.ToString
End Sub

private void ShowSchemaButton_Click(object sender, EventArgs e)
{
    System.IO.StringWriter swXML = new System.IO.StringWriter();
    AuthorsDataSet.WriteXmlSchema(swXML);
    textBox1.Text = swXML.ToString();
}

Testando

Agora você pode testar o formulário para certificar-se de que ele funciona comforme o esperado.

Para testar o formulário

Pressione F5 para executar o aplicativo.
Clique no botão Read XML.

O DataGridView exibe o conteúdo do arquivo XML.
Clique no botão Show Schema.

A caixa de texto exibe o esquema XML para o arquivo XML.

Próximas etapas

Esta explicação passo a passo mostra as noções básicas de ler um arquivo XML em um DataSet, bem como criar um esquema com base no conteúdo do arquivo XML. Aqui estão algumas tarefas que podem vie em seguida:

Edite os dados no DataSet e grave-os de volta como XML. Para obter mais informações, consulte WriteXml.
Edite os dados no DataSet e grave-os em um banco de dados. Para obter mais informações, consulte Salvando dados.

Consulte também

Outros recursos

Explicações Passo a passo sobre Dados

Acesso a dados em Visual Studio

Preparando seu aplicativo para receber dados

Ferramentas XML no Visual Studio

Compartilhar via