XElement.Parse Metoda

Definice

Načtěte XElement z řetězce, který obsahuje XML, volitelně zajistěte, aby se zachovává prázdné znaky a zachovalo informace o řádku.Load an XElement from a string that contains XML, optionally preserving white space and retaining line information.

Přetížení

Parse(String)

Načtěte XElement z řetězce, který obsahuje XML.Load an XElement from a string that contains XML.

Parse(String, LoadOptions)

Načtěte XElement z řetězce, který obsahuje XML, volitelně zajistěte, aby se zachovává prázdné znaky a zachovalo informace o řádku.Load an XElement from a string that contains XML, optionally preserving white space and retaining line information.

Parse(String)

Načtěte XElement z řetězce, který obsahuje XML.Load an XElement from a string that contains XML.

public:
 static System::Xml::Linq::XElement ^ Parse(System::String ^ text);
public static System.Xml.Linq.XElement Parse (string text);
static member Parse : string -> System.Xml.Linq.XElement
Public Shared Function Parse (text As String) As XElement

Parametry

text
String

Obsahující String XML.A String that contains XML.

Návraty

XElement

XElementVyplněný z řetězce, který obsahuje XML.An XElement populated from the string that contains XML.

Příklady

Následující příklad vytvoří řetězec, který obsahuje XML.The following example creates a string that contains XML. Poté analyzuje řetězec na XElement .It then parses the string into an XElement.

XElement xmlTree = XElement.Parse("<Root> <Child> </Child> </Root>");  
Console.WriteLine(xmlTree);  
Dim xmlTree As XElement = <Root><Child></Child></Root>  
Console.WriteLine(xmlTree)  

Tento příklad vytvoří následující výstup:This example produces the following output:

<Root>  
  <Child></Child>  
</Root>  

Poznámky

Tato metoda nezachovává prázdné znaky.This method does not preserve white space. Pokud chcete zachovat prázdné znaky ve stromu XML, použijte přetížení Parse metody, která přijímá LoadOptions jako parametr.If you want to preserve white space in the XML tree, use the overload of the Parse method that takes LoadOptions as a parameter. Další informace naleznete v tématu zachování prázdných znaků při načítání nebo analýze XML a Při serializaci zachovejte prázdnéznaky.For more information, see Preserve white space while loading or parsing XML and Preserve white space while serializing.

Funkce načítání LINQ to XML je postavená na XmlReader .LINQ to XML's loading functionality is built upon XmlReader. Proto můžete zachytit jakékoli výjimky, které jsou vyvolány XmlReader.Create metodami přetížení, a XmlReader metodami, které dokument čtou a analyzují.Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

Platí pro

Parse(String, LoadOptions)

Načtěte XElement z řetězce, který obsahuje XML, volitelně zajistěte, aby se zachovává prázdné znaky a zachovalo informace o řádku.Load an XElement from a string that contains XML, optionally preserving white space and retaining line information.

public:
 static System::Xml::Linq::XElement ^ Parse(System::String ^ text, System::Xml::Linq::LoadOptions options);
public static System.Xml.Linq.XElement Parse (string text, System.Xml.Linq.LoadOptions options);
static member Parse : string * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XElement
Public Shared Function Parse (text As String, options As LoadOptions) As XElement

Parametry

text
String

Obsahující String XML.A String that contains XML.

options
LoadOptions

LoadOptions, Který určuje chování prázdného místa a zda má být načten základní identifikátor URI a informace o řádku.A LoadOptions that specifies white space behavior, and whether to load base URI and line information.

Návraty

XElement

XElementVyplněný z řetězce, který obsahuje XML.An XElement populated from the string that contains XML.

Příklady

Následující příklad analyzuje řetězec do XElement dvou různých způsobů: zachování prázdných znaků a bez zachování mezer.The following example parses a string into an XElement in two different ways: preserving white space, and not preserving white space. Pak použije dotaz k určení počtu prázdných uzlů ve výsledném stromu XML.It then uses a query to determine the number of white space nodes in the resulting XML tree.

int whiteSpaceNodes;  

XElement xmlTree1 = XElement.Parse("<Root> <Child> </Child> </Root>",  
    LoadOptions.None);  
whiteSpaceNodes = xmlTree1  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}",  
    whiteSpaceNodes);  

XElement xmlTree2 = XElement.Parse("<Root> <Child> </Child> </Root>",  
    LoadOptions.PreserveWhitespace);  
whiteSpaceNodes = xmlTree2  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}",  
    whiteSpaceNodes);  
Dim whiteSpaceNodes As Integer  

Dim xmlTree1 As XElement = XElement.Parse("<Root> <Child> </Child> </Root>", LoadOptions.None)  
whiteSpaceNodes = xmlTree1 _  
    .DescendantNodesAndSelf() _  
    .OfType(Of XText)() _  
    .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
    .Count()  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes)  

Dim xmlTree2 As XElement = XElement.Parse("<Root> <Child> </Child> </Root>", LoadOptions.PreserveWhitespace)  
whiteSpaceNodes = xmlTree2 _  
    .DescendantNodesAndSelf() _  
    .OfType(Of XText)() _  
    .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
    .Count()  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes)  

Tento příklad vytvoří následující výstup:This example produces the following output:

Count of white space nodes (not preserving whitespace): 0  
Count of white space nodes (preserving whitespace): 3  

Následující příklad uchovává informace o řádku při analýze řetězce.The following example retains line information as it parses the string.

string markup =  
@"<Root>  
    <Child>  
        <GrandChild/>  
    </Child>  
</Root>";  

XElement xRoot = XElement.Parse(markup, LoadOptions.SetLineInfo);  
Console.WriteLine("{0}{1}{2}",  
    "Element Name".PadRight(20),  
    "Line".PadRight(5),  
    "Position");  
Console.WriteLine("{0}{1}{2}",  
    "------------".PadRight(20),  
    "----".PadRight(5),  
    "--------");  
foreach (XElement e in xRoot.DescendantsAndSelf())  
    Console.WriteLine("{0}{1}{2}",  
        ("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),  
        ((IXmlLineInfo)e).LineNumber.ToString().PadRight(5),  
        ((IXmlLineInfo)e).LinePosition);  
Dim markup As String = _  
"<Root>" & Environment.NewLine & _  
"    <Child>" & Environment.NewLine & _  
"        <GrandChild/>" & Environment.NewLine & _  
"    </Child>" & Environment.NewLine & _  
"</Root>"  

Dim xRoot As XElement = XElement.Parse(markup, LoadOptions.SetLineInfo)  
Console.WriteLine("{0}{1}{2}", _  
    "Element Name".PadRight(20), _  
    "Line".PadRight(5), _  
    "Position")  
Console.WriteLine("{0}{1}{2}", _  
    "------------".PadRight(20), _  
    "----".PadRight(5), _  
    "--------")  
For Each e As XElement In xRoot.DescendantsAndSelf()  
    Console.WriteLine("{0}{1}{2}", _  
        ("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString).PadRight(20), _  
        DirectCast(e, IXmlLineInfo).LineNumber.ToString().PadRight(5), _  
        DirectCast(e, IXmlLineInfo).LinePosition)  
Next  

Tento příklad vytvoří následující výstup:This example produces the following output:

Element Name        Line Position  
------------        ---- --------  
Root                1    2  
  Child             2    6  
    GrandChild      3    10  

Poznámky

Pokud je zdrojový kód XML odsazený, nastavením PreserveWhitespace příznaku v nástroji options způsobí, že čtenář přečte všechny prázdné znaky ve ZDROJOVÉM kódu XML.If the source XML is indented, setting the PreserveWhitespace flag in options causes the reader to read all white space in the source XML. Uzly typu XText jsou vytvořeny pro významné i nevýznamné prázdné znaky.Nodes of type XText are created for both significant and insignificant white space.

Pokud je zdrojový kód XML odsazený, nenastavením PreserveWhitespace příznaku v nástroji options způsobí, že čtenář ignoruje všechny nevýznamné prázdné znaky ve ZDROJOVÉM kódu XML.If the source XML is indented, not setting the PreserveWhitespace flag in options causes the reader to ignore all of the insignificant white space in the source XML. Strom XML je vytvořen bez textových uzlů pro nevýznamné prázdné znaky.The XML tree is created without any text nodes for insignificant white space.

Pokud zdrojový kód XML není odsazený, nastavení PreserveWhitespace příznaku v options nemá žádný vliv.If the source XML is not indented, setting the PreserveWhitespace flag in options has no effect. Významné prázdné znaky jsou pořád zachované a neexistují žádné nevýznamné prázdné znaky, které by mohly způsobit vytváření dalších textových uzlů s prázdnými znaky.Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes.

Další informace naleznete v tématu zachování prázdných znaků při načítání nebo analýze XML a Při serializaci zachovejte prázdnéznaky.For more information, see Preserve white space while loading or parsing XML and Preserve white space while serializing.

Nastavení SetBaseUri nebude mít žádný vliv při analýze z String .Setting SetBaseUri will have no effect when parsing from a String.

XmlReaderMůže obsahovat platné informace o řádku, nebo ne.The XmlReader may have a valid line information or not. Pokud nastavíte SetLineInfo , informace o řádku budou nastaveny ve stromu XML z informací o řádku, který je uveden v XmlReader .If you set SetLineInfo, the line information will be set in the XML tree from the line information that is reported by the XmlReader.

Pokud nastavíte příznak, dojde ke snížení výkonu SetLineInfo .There is a performance penalty if you set the SetLineInfo flag.

Informace o řádku jsou přesné ihned po načtení dokumentu XML.The line information is accurate immediately after loading the XML document. Pokud po načtení dokumentu upravíte strom XML, mohou být informace o řádku nevýznamné.If you modify the XML tree after loading the document, the line information may become meaningless.

Funkce načítání LINQ to XML je postavená na XmlReader .LINQ to XML's loading functionality is built upon XmlReader. Proto můžete zachytit jakékoli výjimky, které jsou vyvolány XmlReader.Create metodami přetížení, a XmlReader metodami, které dokument čtou a analyzují.Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

Platí pro