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

Makale
03/05/2024

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ır`String`.

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ır`String`.
`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:
- Değişmez metin. Sabit metin varsa içindeki elementContents tüm boşluklar önemli hale gelir.
- formunun <%= contentExp %>katıştırılmış ifadesi.
- XML öğesi değişmez değeri.
- XML açıklaması değişmez değeri. Bkz. XML Açıklaması Değişmez Değeri.
- XML işleme yönerge değişmez değeri. Bkz. XML İşleme Yönergesi Değişmez Değeri.
- XML CDATA değişmez değeri. Bkz. XML CDATA Değişmez Değeri.
</[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