Aracılığıyla paylaş

xml öğesi Literal (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çaDescription
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çaDescription
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. Gömülü ifadelerde xml (Visual Basic).

Visual Basic Derleyici aramalar için hazır bir xml öğesi dönüştürür XElement yapıcı ve gerekirse, XAttribute 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 ifadesini (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 Literal (Visual Basic)

xml cdata Literal (Visual Basic)

Imports ifadesini (xml ad alanı)

Kavramlar

Adları bildirilen xml öğeleri ve öznitelikleri (Visual Basic)

Gömülü ifadelerde xml (Visual Basic)

Diğer Kaynaklar

xml değişmezleri (Visual Basic)

Visual Basic'te xml oluşturma