Visual Basic'te LINQ to XML'e Genel Bakış

Visual Basic, XML değişmez değerleri ve XML ekseni özellikleri aracılığıyla LINQ to XML desteği sağlar. Bu, Visual Basic kodunuzda XML ile çalışmak için tanıdık, kullanışlı bir söz dizimi kullanmanızı sağlar. XML değişmez değerleri, XML'i doğrudan kodunuza dahil etmenize olanak tanır. XML ekseni özellikleri, bir XML ifadesinin alt düğümlerine, soy düğümlerine ve özniteliklerine erişmenizi sağlar. Daha fazla bilgi için bkz. Visual Basic'te XML Değişmez Değerlerine Genel Bakış ve XML'ye Erişme.

LINQ to XML, Language-Integrated Sorgusundan (LINQ) yararlanmak için özel olarak tasarlanmış bir bellek içi XML programlama API'sidir. LINQ API'lerini doğrudan çağırabilirsiniz, ancak yalnızca Visual Basic XML değişmez değerlerini bildirmenizi ve XML ekseni özelliklerine doğrudan erişmenizi sağlar.

Uyarı

XML değişmez değerleri ve XML ekseni özellikleri, ASP.NET bir sayfadaki bildirim temelli kodda desteklenmez. Visual Basic XML özelliklerini kullanmak için kodunuzu ASP.NET uygulamanızda arka planda kod içeren bir sayfaya yerleştirin.

İlgili video tanıtımları için bkz. LINQ to XML kullanmaya nasıl başlarım? ve LINQ to XML kullanarak Excel Elektronik Tabloları Nasıl Oluşturulur?.

XML Oluşturma

Visual Basic'te XML ağaçları oluşturmanın iki yolu vardır. Xml değişmez değerini doğrudan kodda bildirebilir veya ağacı oluşturmak için LINQ API'lerini kullanabilirsiniz. Her iki işlem de kodun XML ağacının son yapısını yansıtmasını sağlar. Örneğin, aşağıdaki kod örneği bir XML öğesi oluşturur:

Dim contact1 As XElement = 
    <contact>
      <name>Patrick Hines</name>
      <phone type="home">206-555-0144</phone>
      <phone type="work">425-555-0145</phone>
    </contact>

Daha fazla bilgi için bkz. Visual Basic'te XML oluşturma.

XML'ye Erişme ve Xml'de Gezinme

Visual Basic, XML yapılarına erişmek ve bu yapılarda gezinmek için XML ekseni özellikleri sağlar. Bu özellikler, XML alt öğesi adlarını belirterek XML öğelerine ve özniteliklerine erişmenizi sağlar. Alternatif olarak, öğeleri ve öznitelikleri gezinmek ve bulmak için LINQ yöntemlerini açıkça çağırabilirsiniz. Örneğin, aşağıdaki kod örneği xml öğesinin özniteliklerine ve alt öğelerine başvurmak için XML ekseni özelliklerini kullanır. Kod örneği, alt öğeleri almak ve bunları XML öğeleri olarak çıkarmak için bir LINQ sorgusu kullanır ve dönüştürmeyi etkili bir şekilde gerçekleştirir.

' Place Imports statements at the top of your program.
Imports <xmlns:ns="http://SomeNamespace">

Module Sample1

    Sub SampleTransform()

        ' Create test by using a global XML namespace prefix.

        Dim contact =
            <ns:contact>
                <ns:name>Patrick Hines</ns:name>
                <ns:phone ns:type="home">206-555-0144</ns:phone>
                <ns:phone ns:type="work">425-555-0145</ns:phone>
            </ns:contact>

        Dim phoneTypes =
          <phoneTypes>
              <%= From phone In contact.<ns:phone>
                  Select <type><%= phone.@ns:type %></type>
              %>
          </phoneTypes>

        Console.WriteLine(phoneTypes)
    End Sub

End Module

Daha fazla bilgi için bkz . Visual Basic'te XML'ye erişme.

XML Ad Alanları

Visual Basic, Imports deyimini kullanarak genel XML ad alanı için bir diğer ad belirtmenizi sağlar. Aşağıdaki örnek, XML ad alanını içeri aktarmak için Imports deyiminin nasıl kullanılacağını göstermektedir.

Imports <xmlns:ns="http://someNamespace">

XML ekseni özelliklerine erişim sağladığınızda ve XML belgeleri ile öğeleri için XML değişmez değerleri bildirdiğinizde bir XML ad alanı takma adı kullanabilirsiniz.

Belirli bir ad alanı öneki için bir XNamespace nesnesini, GetXmlNamespace İşlecini kullanarak alabilirsiniz.

Daha fazla bilgi için bkz. Imports Bildirimi (XML Ad Alanı).

XML Değişmez Değerlerinde XML Ad Alanlarını Kullanma

Aşağıdaki örnekte genel ad alanını XElementkullanan bir ns nesnenin nasıl oluşturulacağı gösterilmektedir:

Dim contact1 As XElement = 
    <ns:contact>
        <ns:name>Patrick Hines</ns:name>
        <ns:phone type="home">206-555-0144</ns:phone>
        <ns:phone type="work">425-555-0145</ns:phone>
    </ns:contact>

Console.WriteLine(contact1)

Visual Basic derleyicisi, XML ad alanı takma adlarını içeren XML literal değerlerini, XML ad alanlarını kullanmak için xmlns özniteliğini içeren XML gösterimiyle eşdeğer koda dönüştürür. Derlendiğinde, önceki bölümün örneğindeki kod temelde aşağıdaki örnekle aynı yürütülebilir kodu oluşturur:

Dim contact2 As XElement = 
    <ns1:contact xmlns:ns1="http://someNamespace">
        <ns1:name>Patrick Hines</ns1:name>
        <ns1:phone type="home">206-555-0144</ns1:phone>
        <ns1:phone type="work">425-555-0145</ns1:phone>
    </ns1:contact>

Console.WriteLine(contact2)

XML Ekseni Özelliklerinde XML Ad Alanlarını Kullanma

XML değişmez değerlerinde bildirilen XML ad alanları XML ekseni özelliklerinde kullanılamaz. Ancak, genel ad alanları XML ekseni özellikleriyle kullanılabilir. XML ad alanı ön ekini yerel öğe adından ayırmak için iki nokta kullanın. Aşağıda bir örnek verilmiştir:

Console.WriteLine("Contact name is: " & contact1.<ns:name>.Value)

Ayrıca bakınız

• XML
• Visual Basic'te XML Oluşturma
• Visual Basic'te XML'e Erişme
• Visual Basic'te XML'yi düzenleme