Literál prvek XML (Visual Basic)
Literál představující XElement objektu.
<name [ attributeList ] />
-or-
<name [ attributeList ] > [ elementContents ] </[ name ]>
Části
Termín |
Definice |
< |
Povinné.Otevře počáteční tag elementu. |
name |
Povinné.Název prvku.Formát je jeden z následujících:
ČástDescription
ePrefix Nepovinné.Předpona oboru názvů XML pro prvek.Musí být globální obor názvů XML, který je definován s Imports prohlášení v souboru nebo na úrovni projektu nebo místní obor názvů XML definovaný v tento prvek nebo nadřazený prvek.
eName Povinné.Název prvku.Formát je jeden z následujících:
|
attributeList |
Nepovinné.Seznam atributů deklarované v literál. attribute [ attribute ... ] Každý attribute má jednu z následujících syntaxí:
ČástDescription
aPrefix Nepovinné.Předpona oboru názvů XML pro atribut.Musí být globální obor názvů XML, který je definován s Imports prohlášení nebo místní obor názvů XML definovaný v tento prvek nebo nadřazený prvek.
aName Povinné.Název atributu.Formát je jeden z následujících:
aValue Nepovinné.Hodnota atributu.Formát je jeden z následujících:
|
/> |
Nepovinné.Znamená, že element prázdný element, bez obsahu. |
> |
Povinné.Končí tag elementu počáteční nebo prázdný. |
elementContents |
Nepovinné.Obsah prvku. content [ content ... ] Každý content může být jeden z následujících:
|
</[name]> |
Nepovinné.Představuje uzavírací značku prvku.Nepovinný name parametr není povolena, pokud je výsledkem výrazu vložený. |
Vrácená hodnota
Objekt XElement.
Poznámky
Syntaxe literálu prvek XML slouží k vytvoření XElement objekty v kódu.
[!POZNÁMKA]
Literál XML může zahrnovat více řádků bez použití znaků pokračování řádku.Tato funkce umožňuje kopírování obsahu z dokumentu XML a vložte jej do přímo Visual Basic programu.
Vnořené výrazy ve formuláři <%=exp%> umožňují přidat dynamické informace na prvek XML literálu. Další informace naleznete v tématu Vložený výrazy v jazyce XML (Visual Basic).
Visual Basic Kompilátor převede prvek XML literál volání XElement konstruktor a pokud je to požadováno, XAttribute konstruktor.
Obory názvů XML
Předpony oborů názvů XML jsou užitečné, pokud je nutné vytvořit literály XML s elementy z mnohokrát v kódu stejný obor názvů.Můžete použít globální předpony oborů názvů XML, které definují pomocí Imports prohlášení nebo místní předpony, které definují pomocí xmlns:xmlPrefix= "xmlNamespace" syntaxe atributu.Další informace naleznete v tématu Příkaz Imports (obor názvů XML).
Místní rozlišovací čísla budou mít podle pravidel oborů pro obory názvů XML přednost před globální předpony.Ale pokud literál XML definuje jmenný prostor XML, daného oboru názvů není k dispozici na výrazy, které se zobrazují ve výrazu vložený.Vložený výraz přístup pouze globální názvů XML.
Visual Basic Kompilátor převede každý globální obor názvů XML používaný literál XML do jedné definice místního oboru názvů do generovaného kódu.Globální obory názvů XML, které nejsou používány generovaného kódu nezobrazí.
Příklad
Následující příklad ukazuje, jak vytvořit jednoduchý prvek XML, který má dva vnořené prázdné prvky.
Dim test1 As XElement =
<outer>
<inner1></inner1>
<inner2/>
</outer>
Console.WriteLine(test1)
V příkladu se zobrazí následující text.Všimněte si, že literál zachová strukturu prázdné prvky.
<outer>
<inner1></inner1>
<inner2 />
</outer>
Následující příklad ukazuje, jak používat výrazy vložený prvek a vytvořit atributy.
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)
Tento kód se zobrazí následující text:
<book isbn="1234" author="My Author" year="1999" title="My Book" />
Následující příklad prohlašuje ns jako předponu oboru názvů XML.Potom vytvořte literál XML používá předponu oboru názvů a zobrazí prvku konečné podobě.
' 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
Tento kód se zobrazí následující text:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
Všimněte si, že kompilátor převedeny předponu globální obor názvů XML definice prefix oboru názvů XML.<ns:middle> prvek předefinuje prefix oboru názvů XML pro <ns:inner1> prvek.Však <ns:inner2> prvek používá obor názvů definované Imports prohlášení.
Viz také
Referenční dokumentace
Komentář literál XML (Visual Basic)
XML CDATA literál (Visual Basic)
Příkaz Imports (obor názvů XML)
Koncepty
Názvy prvků XML prohlášené a atributů (Visual Basic)
Vložený výrazy v jazyce XML (Visual Basic)