Aracılığıyla paylaş

XML Öğesi Değişmez Değeri (Visual Basic)

  • Makale

Bir nesneyi temsil eden değişmez XElement değer.

Sözdizimi

<name [ attributeList ] />
-or-
<name [ attributeList ] > [ elementContents ] </[ name ]>

Parça

  • <

    Gerekli. Başlangıç öğesi etiketini açar.

  • name

    Gerekli. Öğesinin adı. Biçim aşağıdakilerden biridir:

    • formun [ePrefix:]eNameöğe adı için değişmez metin; burada:

      Bölüm Açıklama
      ePrefix isteğe bağlı. öğesinin XML ad alanı ön eki. Dosyada veya proje düzeyinde bir Imports deyimle tanımlanan bir genel XML ad alanı ya da bu öğede ya da üst öğede tanımlanan yerel xml ad alanı olmalıdır.
      eName Gerekli. Öğesinin adı. Biçim aşağıdakilerden biridir:

      - Değişmez metin. Bkz. Bildirilen XML Öğelerinin ve Özniteliklerinin Adları.
      - formunun <%= eNameExp %>katıştırılmış ifadesi. türü eNameExp veya örtük olarak dönüştürülebilir XNamebir tür olmalıdırString.

    • formunun <%= nameExp %>katıştırılmış ifadesi. türü nameExp veya türü örtük olarak dönüştürülebilir XNameolmalıdırString. Bir öğenin kapanış etiketinde katıştırılmış ifadeye izin verilmez.

  • attributeList

    isteğe bağlı. Değişmez değerde bildirilen özniteliklerin listesi.

    attribute [ attribute ... ]

    Her attribute biri aşağıdaki söz dizimlerinden birine sahiptir:

    • formun [aPrefix:]aName=aValueöznitelik ataması, burada:

      Bölüm Açıklama
      aPrefix isteğe bağlı. Özniteliği için XML ad alanı ön eki. Bir deyimle Imports tanımlanan bir genel XML ad alanı veya bu öğede ya da üst öğede tanımlanan bir yerel XML ad alanı olmalıdır.
      aName Gerekli. Özniteliğin adı. Biçim aşağıdakilerden biridir:

      - Değişmez metin. Bkz. Bildirilen XML Öğelerinin ve Özniteliklerinin Adları.
      - formunun <%= aNameExp %>katıştırılmış ifadesi. türü aNameExp veya örtük olarak dönüştürülebilir XNamebir tür olmalıdırString.
      aValue isteğe bağlı. Özniteliğin değeri. Biçim aşağıdakilerden biridir:

      - Tırnak içine alınmış değişmez metin.
      - formunun <%= aValueExp %>katıştırılmış ifadesi. Herhangi bir türe izin verilir.

    • formunun <%= aExp %>katıştırılmış ifadesi.

  • />

    isteğe bağlı. öğesinin içerik içermeyen boş bir öğe olduğunu gösterir.

  • >

    Gerekli. Başlangıç veya boş öğe etiketini sonlandırır.

  • elementContents

    isteğe bağlı. öğesinin içeriği.

    content [ content ... ]

    Her content biri aşağıdakilerden biri olabilir:

  • </[name]>

    isteğe bağlı. öğesinin kapanış etiketini temsil eder. Ekli ifadenin sonucu olduğunda isteğe bağlı name parametreye izin verilmez.

Dönüş Değeri

Bir XElement nesnesi.

Açıklamalar

Kodunuzda nesne oluşturmak XElement için XML öğesi değişmez söz dizimini kullanabilirsiniz.

Not

XML değişmez değeri, satır devamlılığı karakterleri kullanmadan birden çok satıra yayılabilir. Bu özellik, bir XML belgesinden içerik kopyalamanızı ve doğrudan Visual Basic programına yapıştırmanızı sağlar.

Formun <%= exp %> eklenmiş ifadeleri, xml öğesi değişmez değerine dinamik bilgi eklemenize olanak tanır. Daha fazla bilgi için bkz . XML'de Katıştırılmış İfadeler.

Visual Basic derleyicisi, XML öğesi değişmez değerini oluşturucuya ve gerekirse oluşturucuya XElement yapılan çağrılara XAttribute dönüştürür.

XML Ad Alanları

XML ad alanı ön ekleri, kodda birçok kez aynı ad alanındaki öğelerle XML değişmez değerleri oluşturmanız gerektiğinde kullanışlıdır. Deyimini kullanarak tanımladığınız genel XML ad alanı ön eklerini veya öznitelik söz dizimini kullanarak Importsxmlns:xmlPrefix="xmlNamespace" tanımladığınız yerel ön ekleri kullanabilirsiniz. Daha fazla bilgi için bkz . Imports Deyimi (XML Ad Alanı).

XML ad alanları için kapsam kuralları uyarınca, yerel ön ekler genel ön eklerden önceliklidir. Ancak, XML değişmez değeri bir XML ad alanını tanımlarsa, bu ad alanı eklenmiş ifadede görünen ifadeler için kullanılamaz. Katıştırılmış ifade yalnızca genel XML ad alanına erişebilir.

Visual Basic derleyicisi, bir XML değişmez değeri tarafından kullanılan her genel XML ad alanını oluşturulan kodda tek bir yerel ad alanı tanımına dönüştürür. Kullanılmayan genel XML ad alanları oluşturulan kodda görünmez.

Örnek 1

Aşağıdaki örnekte, iki iç içe boş öğe içeren basit bir XML öğesinin nasıl oluşturulacağı gösterilmektedir.

Dim test1 As XElement = 
<outer>
    <inner1></inner1>
    <inner2/>
</outer>

Console.WriteLine(test1)

Örnekte aşağıdaki metin görüntülenir. Değişmez değerin boş öğelerin yapısını koruduğuna dikkat edin.

<outer>
  <inner1></inner1>
  <inner2 />
</outer>

Örnek 2

Aşağıdaki örnekte, bir öğeyi adlandırmak ve öznitelikler oluşturmak için katıştırılmış ifadelerin nasıl kullanılacağı gösterilmektedir.

Dim elementType = "book"
Dim authorName = "My Author"
Dim attributeName1 = "year"
Dim attributeValue1 = 1999
Dim attributeName2 = "title"
Dim attributeValue2 = "My Book"

Dim book As XElement = 
<<%= elementType %>
    isbn="1234"
    author=<%= authorName %>
    <%= attributeName1 %>=<%= attributeValue1 %>
    <%= New XAttribute(attributeName2, attributeValue2) %>
/>

Console.WriteLine(book)

Bu kod aşağıdaki metni görüntüler:

<book isbn="1234" author="My Author" year="1999" title="My Book" />

Örnek 3

Aşağıdaki örnekte XML ad alanı ön eki olarak bildirmektedir ns . Ardından bir XML değişmez değeri oluşturmak için ad alanının ön ekini kullanır ve öğenin son biçimini görüntüler.

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

Class TestClass1

    Shared Sub TestPrefix()
        ' Create test using a global XML namespace prefix. 
        Dim inner2 = <ns:inner2/>

        Dim test = 
        <ns:outer>
            <ns:middle xmlns:ns="http://NewNamespace">
                <ns:inner1/>
                <%= inner2 %>
            </ns:middle>
        </ns:outer>

        ' Display test to see its final form. 
        Console.WriteLine(test)
    End Sub

End Class

Bu kod aşağıdaki metni görüntüler:

<ns:outer xmlns:ns="http://SomeNamespace">
  <ns:middle xmlns:ns="http://NewNamespace">
    <ns:inner1 />
    <inner2 xmlns="http://SomeNamespace" />
  </ns:middle>
</ns:outer>

Derleyicinin genel XML ad alanının ön ekini XML ad alanı için bir ön ek tanımına dönüştürdüğüne dikkat edin. <ns:middle> öğesi, ns:inner1> öğesinin XML ad alanı ön ekini <yeniden tanımlar. Ancak, <ns:inner2> öğesi deyimi tarafından Imports tanımlanan ad alanını kullanır.

Ayrıca bkz.