System.FormatException: Unrecognized Guid format.
`Guid.Parse` a primit un text care nu e un GUID valid: e gol, e tăiat, are caractere în afară de `0-9`, `a-f` și cratime sau are alt număr de cifre decât 32. Verifică valoarea și folosește `Guid.TryParse` pentru texte venite din afară (URL, formular, fișier).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un GUID (Guid) are 32 de cifre hexazecimale, scrise de obicei în grupuri de 8-4-4-4-12 separate prin cratime: 3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b. Guid.Parse acceptă și variante cu acolade, cu paranteze sau fără cratime, dar nu acceptă texte cu altă lungime sau cu alte caractere.
Când textul nu se potrivește cu niciun format, primești FormatException: Unrecognized Guid format. Uneori mesajul e mai precis, de exemplu Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Situații frecvente: un id copiat incomplet, un parametru din URL care conține și altceva (id=...&x=1), un text gol pentru un câmp opțional, un id numeric ("42") trimis unui endpoint care așteaptă GUID, sau ghilimele rămase după citirea dintr-un CSV.
Pentru date venite din exterior, Guid.TryParse(text, out Guid id) întoarce false în loc să arunce excepție.
De ce apare: cauzele frecvente
1Id tăiat sau incomplet
var id = Guid.Parse("3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c");var id = Guid.Parse("3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b");Ultimul grup trebuie să aibă 12 cifre hexazecimale; textul avea doar 10.
2Text gol pentru o valoare opțională
string text = "";
var id = Guid.Parse(text);string text = "";
Guid? id = Guid.TryParse(text, out var g) ? g : null;Un câmp gol înseamnă „fără id”, nu un GUID. TryParse tratează cazul fără excepție.
3Ghilimele sau spații din fișier
var id = Guid.Parse("\"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b\"");var id = Guid.Parse("\"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b\"".Trim('"', ' '));Ghilimelele rămase din CSV nu fac parte din GUID. Trim le scoate.
Repară eroarea, direct în pagină
Programul citește id-urile unor comenzi dintr-o listă de texte și se oprește cu System.FormatException: Unrecognized Guid format. la al doilea text, care e tăiat. Repară-l ca id-urile invalide să fie raportate, fără excepție, și programul să afișeze Valid: 3f2b8c1e, Invalid: 91a4-4d2e, Valid: 7d1e0c2a.
string[] texte =
{
"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b",
"91a4-4d2e",
"7d1e0c2a-5b3f-4a8e-9c1d-2e4f6a8b0c1d"
};
foreach (string t in texte)
{
Guid id = Guid.Parse(t);
Console.WriteLine($"Valid: {id.ToString().Substring(0, 8)}");
}Valid: 3f2b8c1e Invalid: 91a4-4d2e Valid: 7d1e0c2a
Indiciu
Există o variantă a metodei de conversie care întoarce bool în loc să arunce excepție.
Reparația
string[] texte =
{
"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b",
"91a4-4d2e",
"7d1e0c2a-5b3f-4a8e-9c1d-2e4f6a8b0c1d"
};
foreach (string t in texte)
{
if (Guid.TryParse(t, out Guid id))
Console.WriteLine($"Valid: {id.ToString().Substring(0, 8)}");
else
Console.WriteLine($"Invalid: {t}");
}De ce merge
Guid.Parse aruncă FormatException când textul nu are 32 de cifre hexazecimale, cum e „91a4-4d2e”. Guid.TryParse încearcă aceeași conversie, dar întoarce false pentru textele invalide, așa că programul poate afișa „Invalid” și trece mai departe. Pentru id-urile valide afișează primele 8 caractere.
Alte forme ale mesajului
System.FormatException: Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).System.FormatException: Guid string should only contain hexadecimal characters.
Cum o eviți pe viitor
- Folosește
Guid.TryParsepentru orice id venit de la utilizator, din URL sau din fișiere. - În ASP.NET Core, pune constrângerea de rută
{id:guid}, ca cererile cu id invalid să primească 404 în loc de excepție. - Curăță textul (
Trim) înainte de conversie.
Întrebări frecvente
Guid.Parse acceptă litere mari?
Da, cifrele hexazecimale pot fi și mari, și mici. Ce contează e numărul lor (32) și caracterele permise.
Cum compar două GUID-uri scrise diferit?
Convertește-le în Guid și compară obiectele: Guid.Parse(a) == Guid.Parse(b). Formatul textului (cu acolade, litere mari) nu mai contează.
Erori înrudite
System.FormatException: The input string 'abc' was not in a correct format. `int.Parse` (sau `double.Parse`, `Convert.ToInt32`) a primit un text care nu este un număr valid: litere, șir gol, zecimale într-un `int`. Folosește `int.TryParse(text, out int n)` și tratează cazul în care întoarce `false`. System.FormatException: The input is not a valid Base-64 string as it contains a non-base 64 character, more than two padding characters, or an illegal character among the padding characters. `Convert.FromBase64String` a primit un text care nu e Base64 standard: are caractere ca `-`, `_`, spații sau prefixe (`Basic `, `data:image/png;base64,`), ori îi lipsește completarea `=` (lungimea nu e multiplu de 4). Curăță textul, înlocuiește `-`/`_` cu `+`/`/` și adaugă `=` până la multiplu de 4. System.ArgumentNullException: Value cannot be null. (Parameter 'source') Ai trimis `null` unei metode care nu-l acceptă. Numele din paranteză (`'source'`, `'key'`, `'s'`) e parametrul care a primit `null`: `source` înseamnă de obicei o colecție `null` folosită cu LINQ. Asigură-te că valoarea există (inițializează colecția, verifică înainte) sau tratează lipsa ei. Î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.
