XDocument.Parse Méthode

Définition

Espace de noms:: System.Xml.Linq

Assemblys:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assemblys:: netstandard.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée une nouvelle XDocument chaîne, en conservant éventuellement des espaces blancs, en définissant l’URI de base et en conservant les informations de ligne.

Surcharges

Nom	Description
Parse(String)	Crée une nouvelle XDocument à partir d’une chaîne.
Parse(String, LoadOptions)	Crée une nouvelle XDocument chaîne, en conservant éventuellement des espaces blancs, en définissant l’URI de base et en conservant les informations de ligne.

Exemples

L’exemple suivant crée une chaîne qui contient du code XML. Il analyse ensuite la chaîne en un XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc = XDocument.Parse(str);
Console.WriteLine(doc);

Dim str As String = _
    "<?xml version= '1.0'?>" & _
    "<!-- comment at the root level -->" & _
    "<Root>" & _
    "  <Child>Content</Child>" & _
    "</Root>"

Dim doc As XDocument = XDocument.Parse(str)
Console.WriteLine(doc)

Cet exemple produit la sortie suivante :

<!-- comment at the root level -->
<Root>
  <Child>Content</Child>
</Root>

Remarques

Cette méthode analyse une chaîne et crée une arborescence XML.

Parse(String)

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Crée une nouvelle XDocument à partir d’une chaîne.

public:
 static System::Xml::Linq::XDocument ^ Parse(System::String ^ text);

public static System.Xml.Linq.XDocument Parse(string text);

static member Parse : string -> System.Xml.Linq.XDocument

Public Shared Function Parse (text As String) As XDocument

Paramètres

text: String

Chaîne qui contient du code XML.

Retours

XDocument

Rempli XDocument à partir de la chaîne qui contient du code XML.

Exemples

L’exemple suivant crée une chaîne qui contient du code XML. Il analyse ensuite la chaîne en un XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc = XDocument.Parse(str);
Console.WriteLine(doc);

Dim str As String = _
    "<?xml version= '1.0'?>" & _
    "<!-- comment at the root level -->" & _
    "<Root>" & _
    "  <Child>Content</Child>" & _
    "</Root>"

Dim doc As XDocument = XDocument.Parse(str)
Console.WriteLine(doc)

Cet exemple produit la sortie suivante :

<!-- comment at the root level -->
<Root>
  <Child>Content</Child>
</Root>

Remarques

Cette méthode ne conserve pas d’espace blanc. Si vous souhaitez conserver l’espace blanc dans l’arborescence XML, utilisez la surcharge de Parse ce LoadOptions paramètre.

Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse xml et conserver l’espace blanc lors de la sérialisation.

La fonctionnalité de chargement de LINQ to XML est basée sur XmlReader. Par conséquent, vous pouvez intercepter toutes les exceptions levées par les XmlReader.Create méthodes de surcharge et les XmlReader méthodes qui lisent et analysent le document.

Voir aussi

S’applique à

Parse(String, LoadOptions)

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Crée une nouvelle XDocument chaîne, en conservant éventuellement des espaces blancs, en définissant l’URI de base et en conservant les informations de ligne.

public:
 static System::Xml::Linq::XDocument ^ Parse(System::String ^ text, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Parse(string text, System.Xml.Linq.LoadOptions options);

static member Parse : string * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XDocument

Public Shared Function Parse (text As String, options As LoadOptions) As XDocument

Paramètres

text: String

Chaîne qui contient du code XML.

options: LoadOptions

Qui LoadOptions spécifie le comportement de l’espace blanc et indique s’il faut charger l’URI de base et les informations de ligne.

Retours

XDocument

Rempli XDocument à partir de la chaîne qui contient du code XML.

Exemples

L’exemple suivant analyse une chaîne en un XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc1 = XDocument.Parse(str, LoadOptions.PreserveWhitespace);
Console.WriteLine("nodes when preserving whitespace: {0}", doc1.DescendantNodes().Count());
XDocument doc2 = XDocument.Parse(str, LoadOptions.None);
Console.WriteLine("nodes when not preserving whitespace: {0}", doc2.DescendantNodes().Count());

Dim str As String = _
"<?xml version= '1.0'?>" & Environment.NewLine & _
"<!-- comment at the root level -->" & Environment.NewLine & _
"<Root>" & Environment.NewLine & _
"    <Child>Content</Child>"  & Environment.NewLine & _
"</Root>"

Dim doc1 As XDocument = XDocument.Parse(str, LoadOptions.PreserveWhitespace)
Console.WriteLine("nodes when preserving whitespace: {0}", doc1.DescendantNodes().Count())
Dim doc2 As XDocument = XDocument.Parse(str, LoadOptions.None)
Console.WriteLine("nodes when not preserving whitespace: {0}", doc2.DescendantNodes().Count())

Cet exemple produit la sortie suivante :

nodes when preserving whitespace: 8
nodes when not preserving whitespace: 4

Remarques

Si le code XML source est mis en retrait, la définition de l’indicateur PreserveWhitespace entraîne options la lecture de tous les espaces blancs dans le code XML source. Les nœuds de type XText sont créés pour un espace blanc significatif et non significatif.

Si le code XML source est mis en retrait, le fait de ne pas définir l’indicateur PreserveWhitespace dans options entraîne l’ignorer tous les espaces blancs non significatifs dans le code XML source. L’arborescence XML est créée sans nœuds de texte pour un espace blanc non significatif.

Si le code XML source n’est pas mis en retrait, la définition de l’indicateur PreserveWhitespace n’a options aucun effet. L’espace blanc significatif est toujours conservé, et il n’existe pas d’étendues d’espace blanc non significatif pouvant entraîner la création de nœuds de texte d’espace blanc plus importants.

Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse xml et conserver l’espace blanc lors de la sérialisation.

Le paramètre SetBaseUri n’est pas valide lors de l’analyse à partir d’un String.

Une pénalité de performance est appliquée si vous définissez l’indicateur SetLineInfo .

Les informations de ligne sont exactes immédiatement après le chargement du document XML. Si vous modifiez l’arborescence XML après le chargement du document, les informations de ligne peuvent devenir sans signification.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?