XML Verilerine Nesne Hiyerarşisi Eşleme

XML belgesi bellekte olduğunda, kavramsal gösterim bir ağaçtır. Programlama için, ağacın düğümlerine erişmek için bir nesne hiyerarşiniz vardır. Aşağıdaki örnekte XML içeriğinin düğümlere nasıl dönüştüğü gösterilmektedir.

XML, XML Belge Nesne Modeli'ne (DOM) okundukça, parçalar düğümlere çevrilir ve bu düğümler kendileriyle ilgili düğüm türleri ve değerleri gibi ek meta verileri korur. Düğüm türü kendi nesnesidir ve hangi eylemlerin gerçekleştirilebileceğini ve hangi özelliklerin ayarlanıp alınabileceğini belirleyen öğedir.

Aşağıdaki basit XML'niz varsa:

Girdi

<book>  
    <title>The Handmaid's Tale</title>  
</book>  

Giriş, bellekte atanan düğüm türü özelliğiyle aşağıdaki düğüm ağacı olarak gösterilir:

Kitap ve başlık düğümü ağaç gösterimi

book öğesi bir XmlElement nesnesi olur, sonraki öğesi titleolan , aynı zamanda bir XmlElement olurken, öğe içeriği bir XmlText nesnesine dönüşür. XmlElement yöntemlerine ve özelliklerine bakıldığında, yöntemler ve özellikler bir XmlText nesnesinde kullanılabilen yöntem ve özelliklerden farklıdır. Dolayısıyla, XML işaretlemesinin hangi düğüm türüne dönüştüğü bilinmesi, düğüm türü gerçekleştirilebilecek eylemleri belirlediği için çok önemlidir.

Aşağıdaki örnek, XML verilerinde okur ve düğüm türüne bağlı olarak farklı metinler yazar. Giriş olarak aşağıdaki XML veri dosyasını kullanarak items.xml:

Girdi

<?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>  

Aşağıdaki kod örneği items.xml dosyasını okur ve her düğüm türüne ilişkin bilgileri görüntüler.

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  

Örnekten alınan çıktı, düğüm türlerine veri eşlemesini gösterir.

Çıktı

<?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>

Girişi bir kerede bir satır alarak ve koddan oluşturulan çıkışı kullanarak, hangi düğüm testinin hangi çıkış satırlarını ürettiğini analiz etmek için aşağıdaki tabloyu kullanabilir ve böylece hangi XML verilerinin ne tür bir düğüm türüne dönüştüdüğünü anlayabilirsiniz.

Düğüm türü ne tür eylemlerin geçerli olduğunu ve ne tür özellikleri ayarlayıp alabileceğinizi denetlediği için, hangi düğüm türünün atandığı bilmeniz gerekir.

Boşluk için düğüm oluşturma, veriler PreserveWhitespace bayrağıyla DOM'a yüklendiğinde denetlenilir. Daha fazla bilgi için bkz . DOM Yüklenirken Boşluk ve Önemli Boşluk İşleme.

DOM'a yeni düğümler eklemek için bkz . XML Belgesine Düğüm Ekleme. DOM'dan düğümleri kaldırmak için bkz . XML Belgesinden Düğümleri, İçeriği ve Değerleri Kaldırma. DOM'daki düğümlerin içeriğini değiştirmek için bkz . XML Belgesindeki Düğümleri, İçeriği ve Değerleri Değiştirme.

Ayrıca bkz.

• XML Belge Nesne Modeli (DOM)