Aracılığıyla paylaş

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

  • Makale

Gösteren bir sabit bir XElement nesne.

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

Bölümleri

Terim

Tanım

<

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

name

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

  • Edebi Metin öğenin adını formu ePrefix:eName, burada:

Parça

Description

ePrefix

İsteğe Bağlı.xml ad alanı öneki öðe için.İle tanımlanan genel bir xml ad alanı olması gereken bir Imports dosyası veya proje düzeyinde veya bu öğenin veya üst öğe tanımlanan yerel bir xml ad alanı bildirimi.

eName

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

  • Deyim gömülü <%=nameExp%>.  Tür nameExp olması String veya örtük olarak dönüştürülebilir bir tür XName.Katıştırılmış bir ifade bir öðenin bir kapatma etiketi içinde izin verilmez.

attributeList

İsteğe Bağlı.Öznitelik listesi hazır bildirilen.

attribute [ attribute ... ]

Her attribute aşağıdaki sözdizimlerinden birini sahiptir:

  • Attribute assignment, of the form aPrefix:aName=aValue, where:

Parça

Description

aPrefix

İsteğe Bağlı.xml ad alanı öneki özniteliği.İle tanımlanan genel bir xml ad alanı olması gereken bir Imports deyimi veya bu öğenin veya üst öğe tanımlanan yerel bir xml ad alanı.

aName

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

aValue

İsteğe Bağlı.Öznitelik değeri.Biçim aşağıdakilerden biridir:

  • Tırnak içine alınmış Edebi Metin.

  • Deyim gömülü <%=aValueExp%>.  Her türlü izin verilir.

  • Deyim gömülü <%=aExp%>.  

/>

İsteğe Bağlı.Öðenin içeriði olmayan boş bir öğe olduğunu gösterir.

>

Gerekli.Deneyimsiz ya da boş öğe etiketi sona erer.

elementContents

İsteğe Bağlı.Öğe içeriği.

content [ content ... ]

Her content aşağıdakilerden biri olabilir:

</[name]>

İsteğe Bağlı.Öğe için kapanış etiketini temsil eder.İsteğe bağlı name parametresi, katıştırılmış bir ifadenin sonucunu olduğunda verilmez.

Dönüş Değeri

Bir XElement nesne.

Notlar

xml öğesi değişmez sözdizimini oluşturmak için kullanabileceğiniz XElement kodunuzdaki nesnelerin.

[!NOT]

Bir xml değişmezi, satır devamı karakterleri kullanmadan birden çok satıra yayılabilir.Bu özellik, içerik bir xml belgesinden kopyalayıp doğrudan içine yapıştırmak sağlar bir Visual Basic program.

Gömülü ifadelerde formun <%=exp%> , bir xml öğesi hazır dinamik bilgi eklemenize olanak tanır.  Daha fazla bilgi için bkz. XML'de Katıştırılmış İfadeler (Visual Basic).

Visual Basic Derleyici aramalar için hazır bir xml öğesi dönüştürür #ctor yapıcı ve gerekirse, #ctor kurucusu.

xml ad boşlukları

xml ad alaný önekleri kodunda birden çok kez aynı ad alanından öğe ile xml değişmezleri oluşturmak zorunda olduğunda yararlıdır.Kullanarak tanımlayan genel xml ad alaný önekleri kullanabilirsiniz Imports deyimi veya kullanarak tanımladığınız yerel önekleri xmlns:xmlPrefix= "xmlNamespace" öznitelik sözdizimi.Daha fazla bilgi için bkz. Imports Deyimi (XML Ad Alanı).

xml ad alanları için ölçüm kuralları gereğince yerel önekleri genel önekleri'ne göre önceliğe sahiptir.Ancak, xml değişmez bir xml ad alanı tanımlıyorsa, bu ad, katıştırılmış bir deyim içinde görünen ifadeler kullanılabilir değil.Katıştırılmış ifade yalnızca genel xml ad erişebilirsiniz.

Visual Basic Derleyicisi bir xml değişmezi oluşturulan kodda tek bir yerel ad alanı tanımı içinde kullanılan genel her xml ad alanı.Kullanılmayan genel xml ad alanları oluşturulan kodda görünmez.

Örnek

Aşağıdaki örnek, iç içe iki boþ öðeleri içeren basit bir xml öğesi oluşturulması gösterilmiştir.

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

Console.WriteLine(test1)

Örneğin, aşağıdaki metni görüntüler.Hazır bilgi boþ öðeler yapısını korur dikkat edin.

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

Aşağıdaki örnek, gömülü ifadeleri bir öğe adı ve öznitelikler oluşturmak için nasıl kullanılacağını gösterir.

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 kodu aşağıdaki metni görüntüler:

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

Aşağıdaki örnek bildirir ns bir xml ad alanı öneki olarak.Bir xml değişmezi oluşturmak için ad alanı önekini kullanır ve son öğenin formu 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 kodu 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>

Global xml ad alanı öneki derleyici bir xml ad alanı öneki tanımı metne dönüştürülecek dikkat edin.<ns:middle> <ns:inner1> xml ad alaný önekini öðe yeniden tanımlar öğe.Ancak, <ns:inner2> öğe tarafından tanımlanan ad alanı kullanan Imports ifadesi.

Ayrıca bkz.

Başvuru

XElement

XML Açıklama Değişmez Değeri (Visual Basic)

XML CDATA Değişmez Değeri (Visual Basic)

Imports Deyimi (XML Ad Alanı)

Kavramlar

Bildirilmiş XML Öğeleri ve Özniteliklerinin Adları (Visual Basic)

XML'de Katıştırılmış İfadeler (Visual Basic)

Diğer Kaynaklar

XML Değişmez Değerleri (Visual Basic)

Visual Basic'de XML Oluşturma