Mapeando a hierarquia do objeto para dados XML
Quando um documento XML está na memória, a representação conceitual é uma árvore. Para programar, você tem uma hierarquia de objeto para acessar os nós da árvore. O exemplo a seguir mostra como o conteúdo XML torna-se nós.
Como o XML é lido no DOM (Document Object Model) XML, as partes são traduzidas em nós e esses nós mantêm metadados adicionais sobre si mesmos, como seu tipo de nó e valores. O tipo de nó é seu objeto e é o que determina quais ações podem ser executadas e quais propriedades podem ser definidas ou recuperadas.
Se você tiver o XML simples a seguir:
Entrada
<book>
<title>The Handmaid's Tale</title>
</book>
A entrada é representada na memória como a árvore de nó a seguir com a propriedade de tipo de nó atribuída:
Representação da árvore do nó do livro e do título
O elemento book torna-se um objeto XmlElement, o elemento a seguir, title, também se torna XmlElement, enquanto o conteúdo do elemento se torna um objeto XmlText. Ao analisar os métodos e as propriedades XmlElement, eles são diferentes dos métodos e das propriedades disponíveis em um objeto XmlText. Portanto, saber qual tipo de nó a marcação XML se torna é vital, porque o tipo de nó determina as ações que podem ser executadas.
O exemplo a seguir lê dados XML e remove o texto diferente, dependendo do tipo de nó. Usando o seguinte arquivo de dados XML como entrada, items.xml:
Entrada
<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
<Item>Test with an entity: &number;</Item>
<Item>test with a child element <more/> stuff</Item>
<Item>test with a CDATA section <![CDATA[<456>]]> def</Item>
<Item>Test with a char entity: A</Item>
<!-- Fourteen chars in this element.-->
<Item>1234567890ABCD</Item>
</Items>
O exemplo de código a seguir lê o arquivo items.xml e exibe informações para cada tipo de nó.
Imports System
Imports System.IO
Imports System.Xml
Public Class Sample
Private Const filename As String = "items.xml"
Public Shared Sub Main()
Dim reader As XmlTextReader = Nothing
Try
' Load the reader with the data file and
'ignore all white space nodes.
reader = New XmlTextReader(filename)
reader.WhitespaceHandling = WhitespaceHandling.None
' Parse the file and display each of the nodes.
While reader.Read()
Select Case reader.NodeType
Case XmlNodeType.Element
Console.Write("<{0}>", reader.Name)
Case XmlNodeType.Text
Console.Write(reader.Value)
Case XmlNodeType.CDATA
Console.Write("<![CDATA[{0}]]>", reader.Value)
Case XmlNodeType.ProcessingInstruction
Console.Write("<?{0} {1}?>", reader.Name, reader.Value)
Case XmlNodeType.Comment
Console.Write("<!--{0}-->", reader.Value)
Case XmlNodeType.XmlDeclaration
Console.Write("<?xml version='1.0'?>")
Case XmlNodeType.Document
Case XmlNodeType.DocumentType
Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)
Case XmlNodeType.EntityReference
Console.Write(reader.Name)
Case XmlNodeType.EndElement
Console.Write("</{0}>", reader.Name)
End Select
End While
Finally
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub 'Main ' End class
End Class 'Sample
using System;
using System.IO;
using System.Xml;
public class Sample
{
private const String filename = "items.xml";
public static void Main()
{
XmlTextReader reader = null;
try
{
// Load the reader with the data file and ignore
// all white space nodes.
reader = new XmlTextReader(filename);
reader.WhitespaceHandling = WhitespaceHandling.None;
// Parse the file and display each of the nodes.
while (reader.Read())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
Console.Write("<{0}>", reader.Name);
break;
case XmlNodeType.Text:
Console.Write(reader.Value);
break;
case XmlNodeType.CDATA:
Console.Write("<![CDATA[{0}]]>", reader.Value);
break;
case XmlNodeType.ProcessingInstruction:
Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
break;
case XmlNodeType.Comment:
Console.Write("<!--{0}-->", reader.Value);
break;
case XmlNodeType.XmlDeclaration:
Console.Write("<?xml version='1.0'?>");
break;
case XmlNodeType.Document:
break;
case XmlNodeType.DocumentType:
Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
break;
case XmlNodeType.EntityReference:
Console.Write(reader.Name);
break;
case XmlNodeType.EndElement:
Console.Write("</{0}>", reader.Name);
break;
}
}
}
finally
{
if (reader != null)
reader.Close();
}
}
} // End class
A saída do exemplo revela o mapeamento dos dados para os tipos de nó.
Saída
<?xml version='1.0'?><!--This is a sample XML document --><!DOCTYPE Items [<!ENTITY number "123">]<Items><Item>Test with an entity: 123</Item><Item>test with a child element <more> stuff</Item><Item>test with a CDATA section <![CDATA[<456>]]> def</Item><Item>Test with a char entity: A</Item><--Fourteen chars in this element.--><Item>1234567890ABCD</Item></Items>
Utilizando a entrada uma linha de cada vez e usando a saída gerada do código, você poderá usar a tabela a seguir para analisar qual teste do nó gerou as linhas de saída, entendendo, portanto, quais dados XML se transformaram em qual tipo de nó.
| Entrada | Saída | Teste de tipo de nó |
|---|---|---|
| <?xml version="1.0"?> | <?xml version='1.0'?> | XmlNodeType.XmlDeclaration |
| <!-- This is a sample XML document --> | <!--This is a sample XML document --> | XmlNodeType.Comment |
| <!DOCTYPE Items [<!ENTITY number "123">]> | <!DOCTYPE Items [<!ENTITY number "123">] | XmlNodeType.DocumentType |
| <Itens> | <Itens> | XmlNodeType.Element |
| <Item> | <Item> | XmlNodeType.Element |
| Teste com uma entidade: &number; | Teste com uma entidade: 123 | XmlNodeType.Text |
| </Item> | </Item> | XmlNodeType.EndElement |
| <Item> | <Item> | XmNodeType.Element |
| teste com um elemento filho | teste com um elemento filho | XmlNodeType.Text |
| <more> | <more> | XmlNodeType.Element |
| material | material | XmlNodeType.Text |
| </Item> | </Item> | XmlNodeType.EndElement |
| <Item> | <Item> | XmlNodeType.Element |
| teste com uma seção CDATA | teste com uma seção CDATA | XmlTest.Text |
| <![CDATA[<456>]]> | <![CDATA[<456>]]> | XmlTest.CDATA |
| def | def | XmlNodeType.Text |
| </Item> | </Item> | XmlNodeType.EndElement |
| <Item> | <Item> | XmlNodeType.Element |
| Teste com uma entidade de caracteres: A | Teste com uma entidade de caracteres: A | XmlNodeType.Text |
| </Item> | </Item> | XmlNodeType.EndElement |
| <!-- Fourteen chars in this element.--> | <--Fourteen chars in this element.--> | XmlNodeType.Comment |
| <Item> | <Item> | XmlNodeType.Element |
| 1234567890ABCD | 1234567890ABCD | XmlNodeType.Text |
| </Item> | </Item> | XmlNodeType.EndElement |
| </Items> | </Items> | XmlNodeType.EndElement |
Você deve saber qual tipo de nó é atribuído, porque o tipo de nó controla quais tipos de ações são válidos e qual tipo de propriedades você pode definir e recuperar.
A criação do nó para o espaço em branco é controlada quando os dados são carregados no DOM pelo sinalizador PreserveWhitespace. Para saber mais, confira Espaço em branco e tratamento de espaço em branco significativo ao carregar o DOM.
Para adicionar novos nós para o DOM, consulte Inserir nós em um documento XML. Para remover os nós do DOM, consulte Remover nós, conteúdo e valores de um documento XML. Para modificar o conteúdo de nós no DOM, consulte Modificar nós, conteúdo e valores em um documento XML.
