Přehled literály XML (Visual Basic)

Literál XML umožňuje zahrnout XML přímo do vašeho Visual Basic kód. Syntaxe literálu XML představuje Technologie LINQ to XML objekty a je podobná syntaxi XML 1.0. Usnadňuje vytvořit prvky XML a dokumenty programově, protože kód má stejnou strukturu jako konečné XML.

Visual Basickompiluje literály XML do Technologie LINQ to XML objektů.Technologie LINQ to XMLposkytuje jednoduchý objektový model pro vytvoření a manipulaci s XML a tento model integruje s LINQ (Language-Integrated Query).Další informace naleznete v tématu XElement.

Můžete vložit Visual Basic výrazu literál XML.Za běhu aplikace vytvoří Technologie LINQ to XML pro každý literál, zahrnutí hodnoty výrazů vložený objekt.To umožňuje určit dynamický obsah uvnitř literál XML.Další informace naleznete v tématu Vložený výrazy v jazyce XML (Visual Basic).

Další informace o rozdílech mezi XML syntaxi literálu a syntaxe XML 1.0, viz XML literály a XML 1.0 specifikace (Visual Basic).

Jednoduché literály

Můžete vytvořit Technologie LINQ to XML objektu ve vaší Visual Basic zadáním nebo vložením v XML platný kód.Vrátí hodnotu literálu prvek XML XElement objektu.Další informace naleznete v tématu Literál prvek XML (Visual Basic) a XML literály a XML 1.0 specifikace (Visual Basic).Následující příklad vytvoří element XML, který má několik podřízených elementů.

Dim contact1 As XElement = 
    <contact>
      <name>Patrick Hines</name>
      <phone type="home">206-555-0144</phone>
      <phone type="work">425-555-0145</phone>
    </contact>

Můžete vytvořit dokument XML pomocí spuštění s literál XML <?xml version="1.0"?>, jak ukazuje následující příklad.Vrátí hodnotu literálu dokumentu XML XDocument objektu.Další informace naleznete v tématu Literál dokumentu XML (Visual Basic).

Dim contactDoc As XDocument = 
    <?xml version="1.0"?>
    <contact>
      <name>Patrick Hines</name>
      <phone type="home">206-555-0144</phone>
      <phone type="work">425-555-0145</phone>
    </contact>

[!POZNÁMKA]

Syntaxe literálu XML v Visual Basic není shodný syntaxe ve specifikaci XML 1.0.Další informace naleznete v tématu XML literály a XML 1.0 specifikace (Visual Basic).

Pokračování řádku

Literál XML může zahrnovat více řádků bez použití znaků pokračování řádku (zadejte místo podtržení posloupnost).Usnadňuje porovnat literály XML kód s dokumenty XML.

Kompilátor zpracovává znaky pokračování řádku jako součást literál XML.Proto používejte sekvenci zadejte místo podtržení pouze patří Technologie LINQ to XML objektu.

Znaky pro pokračování řádku však nutné, máte-li ve výrazu vložený víceřádkové výraz.Další informace naleznete v tématu Vložený výrazy v jazyce XML (Visual Basic).

Vkládání dotazů v XML literály

Dotaz lze použít ve výrazu vložený.Pokud to uděláte, prvky vrácené dotazem jsou přidány do prvku XML.To umožňuje přidání dynamického obsahu, například výsledek dotazu uživatele na literál XML.

Například následující kód používá vložené dotazu vytvořit prvky XML z členů phoneNumbers2 pole a přidejte jako podřízené prvky, contact2.

Public Class XmlSamples

  Public Sub Main()
    ' Initialize the objects. 

    Dim phoneNumbers2 As Phone() = { 
        New Phone("home", "206-555-0144"), 
        New Phone("work", "425-555-0145")}

    ' Convert the data contained in phoneNumbers2 to XML. 

    Dim contact2 = 
        <contact>
          <name>Patrick Hines</name>
          <%= From p In phoneNumbers2 
            Select <phone type=<%= p.Type %>><%= p.Number %></phone> 
          %>
        </contact>

    Console.WriteLine(contact2)
  End Sub

End Class

Class Phone
  Public Type As String
  Public Number As String
  Public Sub New(ByVal t As String, ByVal n As String)
    Type = t
    Number = n
  End Sub
End Class

Jakým způsobem kompilátor vytvoří objekty XML literály

Visual Basic Kompilátor přeloží na volání na ekvivalent literály XML Technologie LINQ to XML konstruktory vybudovat Technologie LINQ to XML objektu.Například Visual Basic kompilátor přeloží následující příklad kódu do volání XProcessingInstruction volání konstruktoru instrukce XML verze, do XElement konstruktor pro <contact>, <name>, a <phone> prvky a volání XAttribute konstruktor pro type atributu.Atributy konkrétně uvedeny v následující ukázce Visual Basic kompilátor bude volat XAttribute(XName, Object) dvakrát konstruktor.První předá hodnotu type pro name parametru a hodnota home pro value parametr.Druhý předá také hodnotu type pro name parametr, ale hodnota work pro value parametr.

Dim contactDoc As XDocument = 
    <?xml version="1.0"?>
    <contact>
      <name>Patrick Hines</name>
      <phone type="home">206-555-0144</phone>
      <phone type="work">425-555-0145</phone>
    </contact>

Viz také

Referenční dokumentace

Literál dokumentu XML (Visual Basic)

Literál prvek XML (Visual Basic)

XElement

Koncepty

Vložený výrazy v jazyce XML (Visual Basic)

Další zdroje

Vytvoření XML v jazyce Visual Basic

Literály XML (Visual Basic)