Demonstra Passo a passo: Lendo dados XML em um DataSet

  • Artigo

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:

  1. Criando um novo projeto.

  2. Criar um arquivo XML a ser lido no DataSet.

  3. Criando a interface do usuário.

  4. Creating the dataset, read the XML file, and display it in a DataGridView control.

  5. Adding code to display the XML Schema based on the XML file in a TextBox control.

Observação:

Caixas de diálogo e comandos de menu que você vê podem diferir esses desc ribed na Ajuda dependendo das configurações ativas ou edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Criar um novo projeto

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

Para criar o novo projeto Windows

  1. No menu File, crie um novo projeto.

  2. Nomeie o projeto ReadingXML.

  3. 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

  1. No menu Project, escolha Add New Item.

  2. Selecione XML File, nomeie o arquivo authors.xml, e clique em Add.

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

  3. 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>

  4. 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

  1. Open Form1 in design view.

  2. No Toolbox, arraste os seguintes controles no formulário:

  3. 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 Datasets in Visual Studio Overview.

Para criar um novo DataSet que receberá os dados XML

  1. Com o arquivo fonte para Form1 selecionado em Solution Explorer, clique no botão View Designer na barra de ferramentas Solution Explorer.

  2. From the Guia de dados, caixa de ferramentas, drag a DataSet onto Form1.

  3. Select Untyped dataset on the Caixa de Diálogo Add Dataset, and then click OK.

    DataSet1 é adicionado à bandeja do componente.

  4. 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

  1. No Solution Explorer, selecione Form1 e clique no View Designer botão da barra de ferramentas Solution Explorer.

  2. Clique duas vezes no botão Read XML.

    The Code Editor opens at the ReadXmlButton_Click event handler.

  3. Type the following code into the ReadXmlButton_Click event handler:

    Private Sub ReadXmlButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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";
}

  4. 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

  1. No Solution Explorer, selecione Form1 e clique no botão View Designer.

  2. Clique duas vezes no botão Show Schema.

    The Code Editor opens at the ShowSchemaButton_Click event handler.

  3. Type the following code into the ShowSchemaButton_Click event handler.

    Private Sub ShowSchemaButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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

  1. Pressione F5 para executar o aplicativo.

  2. Clique no botão Read XML.

    O DataGridView exibe o conteúdo do arquivo XML.

  3. 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

Acessando Dados (Visual Studio)

Preparando seu aplicativo para receber dados

Ferramentas XML no Visual Studio