Literál XML elementu (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:
|
||||||||
attributeList |
Nepovinné.Seznam atributů deklarované v literál. attribute [ attribute ... ] Každý attribute má jednu z následujících syntaxí:
|
||||||||
/> |
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 XML (Visual Basic).
Visual Basic Kompilátor převede prvek XML literál volání #ctor konstruktor a pokud je to požadováno, #ctor 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 Imports – Příkaz (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
Literál komentáře XML (Visual Basic)
Literál XML CDATA (Visual Basic)
Imports – Příkaz (obor názvů XML)
Koncepty
Názvy deklarovaných XML elementů a atributů (Visual Basic)
Vložené výrazy v XML (Visual Basic)