...
Eroare C# · Excepții la rulare: null, conversii, aritmetică

System.FormatException: Unrecognized Guid format.

Pe scurt

`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

Greșit
C#
var id = Guid.Parse("3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c");
Corect
C#
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ă

Greșit
C#
string text = "";
var id = Guid.Parse(text);
Corect
C#
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

Greșit
C#
var id = Guid.Parse("\"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b\"");
Corect
C#
var id = Guid.Parse("\"3f2b8c1e-91a4-4d2e-b7c3-5e8f1a2d4c6b\"".Trim('"', ' '));

Ghilimelele rămase din CSV nu fac parte din GUID. Trim le scoate.

Repară tu

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.

Codul care dă eroarea
C#
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)}");
}
După reparație, programul afișează
Valid: 3f2b8c1e
Invalid: 91a4-4d2e
Valid: 7d1e0c2a
Indiciu

Există o variantă a metodei de conversie care întoarce bool în loc să arunce excepție.

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.TryParse pentru 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

← 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.