System.Xml.XmlException: Data at the root level is invalid. Line 1, position 1.
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") metodeiParse, deci parserul încearcă să citească litereleproduse.xmlca XML; pentru fișiere se foloseșteXDocument.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
var doc = XDocument.Parse("produse.xml");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
string raspuns = await client.GetStringAsync(url);
var doc = XDocument.Parse(raspuns);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ă
var doc = XDocument.Parse("<produs/><produs/>");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ă 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.
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");Mouse: 80 lei Monitor: 700 lei
Indiciu
Metoda folosită primește textul XML, nu calea către fișier.
Reparația
using System.Xml.Linq;
File.WriteAllText("produse.xml", "<produse><produs nume=\"Mouse\" pret=\"80\"/><produs nume=\"Monitor\" pret=\"700\"/></produse>");
var doc = XDocument.Load("produse.xml");
foreach (var p in doc.Descendants("produs"))
Console.WriteLine($"{p.Attribute("nume").Value}: {p.Attribute("pret").Value} lei");De ce merge
XDocument.Parse a primit textul produse.xml, adică numele fișierului, și a încercat să-l citească drept XML. XDocument.Load deschide fișierul de la acea cale și parsează conținutul lui. Apoi Descendants("produs") găsește cele două produse și citește atributele nume și pret. Conținutul fișierului era corect de la început; doar metoda de citire era greșită.
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 textXDocument.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
System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0. Textul dat lui `JsonSerializer.Deserialize` nu este JSON valid. Caracterul dintre apostrofuri e primul lucru greșit: `'<'` înseamnă de obicei că ai primit o pagină HTML (o eroare a serverului), iar `'''` că valorile sunt între apostrofuri în loc de ghilimele. Verifică textul înainte și tratează `JsonException`. System.IO.FileNotFoundException: Could not find file 'C:\Proiecte\Magazin\bin\Debug\net9.0\config.json'. Fișierul pe care vrei să-l citești nu există la calea folosită. De cele mai multe ori calea e relativă și se rezolvă față de folderul din care rulează programul (`bin/Debug/net9.0`), nu față de folderul proiectului. Verifică cu `File.Exists`, folosește o cale corectă sau copiază fișierul la build. System.Text.Json.JsonException: '"' is invalid after a value. Expected either ',', '}', or ']'. Path: $ | LineNumber: 2 | BytePositionInLine: 0. JSON-ul are o problemă după o valoare: de cele mai multe ori lipsește o virgulă între două proprietăți sau elemente, ori există un comentariu (`//`) sau text în plus. Mesajul îți spune caracterul găsit și linia (numărată de la 0). Adaugă virgula lipsă sau, pentru comentarii, folosește `ReadCommentHandling = JsonCommentHandling.Skip`. Î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.
