...
Eroare C# · Fișiere, HTTP, URI și JSON

System.Xml.XmlException: Data at the root level is invalid. Line 1, position 1.

Pe scurt

Parserul XML a primit un text care nu începe cu XML valid. Cel mai des ai dat lui `XDocument.Parse` / `LoadXml` calea fișierului în loc de conținut, sau textul e JSON, HTML de eroare ori are caractere înainte de `<`. Pentru fișiere folosește `XDocument.Load(cale)`, iar pentru text verifică ce primești.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

XDocument.Parse(text) și XmlDocument.LoadXml(text) așteaptă conținutul XML, care trebuie să înceapă cu < (declarația <?xml ...?> sau elementul rădăcină). Dacă primul caracter nu poate începe un document XML, primești System.Xml.XmlException: Data at the root level is invalid. Line 1, position 1.. Linia și poziția îți arată unde a găsit parserul primul caracter neașteptat.

Cauze frecvente:

  • ai trimis calea fișierului ("produse.xml") metodei Parse, deci parserul încearcă să citească literele produse.xml ca XML; pentru fișiere se folosește XDocument.Load;
  • un API a întors JSON sau o pagină de eroare, nu XML;
  • există caractere înainte de XML: spații, un BOM dublat, text de log.

Alte mesaje din aceeași familie: There are multiple root elements (două elemente pe nivelul de sus, fără un părinte comun) și The 'produs' start tag ... does not match the end tag of 'produse' (taguri închise greșit).

De ce apare: cauzele frecvente

1Calea fișierului dată lui Parse

Greșit
C#
var doc = XDocument.Parse("produse.xml");
Corect
C#
var doc = XDocument.Load("produse.xml");

Load citește fișierul de la cale; Parse primește direct textul XML.

2Răspunsul API-ului nu e XML

Greșit
C#
string raspuns = await client.GetStringAsync(url);
var doc = XDocument.Parse(raspuns);
Corect
C#
string raspuns = await client.GetStringAsync(url);
if (!raspuns.TrimStart().StartsWith("<"))
    throw new InvalidDataException($"Raspuns neasteptat: {raspuns[..Math.Min(50, raspuns.Length)]}");
var doc = XDocument.Parse(raspuns);

Verifici ce ai primit și afișezi începutul răspunsului când nu e XML.

3Mai multe elemente rădăcină

Greșit
C#
var doc = XDocument.Parse("<produs/><produs/>");
Corect
C#
var doc = XDocument.Parse("<produse><produs/><produs/></produse>");

Un document XML are un singur element rădăcină care le conține pe celelalte.

Repară tu

Repară eroarea, direct în pagină

Programul citește produsele dintr-un fișier XML, dar se oprește cu System.Xml.XmlException: Data at the root level is invalid. Line 1, position 1. Repară citirea ca programul să afișeze Mouse: 80 lei și Monitor: 700 lei.

Codul care dă eroarea
C#
using System.Xml.Linq;

File.WriteAllText("produse.xml", "<produse><produs nume=\"Mouse\" pret=\"80\"/><produs nume=\"Monitor\" pret=\"700\"/></produse>");

var doc = XDocument.Parse("produse.xml");
foreach (var p in doc.Descendants("produs"))
    Console.WriteLine($"{p.Attribute("nume").Value}: {p.Attribute("pret").Value} lei");
După reparație, programul afișează
Mouse: 80 lei
Monitor: 700 lei
Indiciu

Metoda folosită primește textul XML, nu calea către fișier.

Alte forme ale mesajului

  • System.Xml.XmlException: There are multiple root elements. Line 1, position 11.
  • System.Xml.XmlException: The 'produs' start tag on line 1 position 11 does not match the end tag of 'produse'. Line 1, position 20.
  • System.Xml.XmlException: Root element is missing.

Cum o eviți pe viitor

  • Pentru fișiere folosește XDocument.Load(cale), pentru text XDocument.Parse(text).
  • Când datele vin din rețea, verifică tipul conținutului (Content-Type) și codul de răspuns înainte de parsare.
  • Generează XML cu XDocument / XElement, nu prin concatenare de text, ca să eviți taguri neînchise.

Întrebări frecvente

Ce înseamnă Line 1, position 1?

Că parserul a refuzat chiar primul caracter. Aproape mereu înseamnă că textul nu e XML deloc: o cale de fișier, JSON, HTML sau un mesaj de eroare.

Ce e Root element is missing?

Apare când textul sau fișierul e gol (sau conține doar spații și comentarii). Verifică dacă fișierul a fost scris complet și dacă citești calea corectă.

Erori înrudite

← Toate erorile C#

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C# de la zero, cu exerciții la fiecare lecție

Curs C#: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.