System.FormatException: Format specifier was invalid.
Ai cerut un format numeric care nu există pentru acel tip, de exemplu `"D2"` sau `"X2"` pe un `decimal` / `double` (aceste formate merg doar pe întregi). Pentru zecimale folosește `"F2"`, `"N2"` sau `"0.00"`, iar pentru `D` și `X` convertește întâi la `int`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Formatele standard sunt o literă, opțional urmată de un număr: C (monedă), D (întreg cu zerouri în față), E, F (zecimale fixe), G, N (cu separator de mii), P (procent), R, X (hexazecimal). Unele merg doar pe anumite tipuri: D și X doar pe tipuri întregi (int, long, byte). Când ceri unul dintre ele pe un double sau decimal, ori folosești o literă care nu e format standard ("Q", "L2"), primești System.FormatException: Format specifier was invalid..
Excepția apare la rulare, la ToString("..."), la string.Format("{0:...}") sau în interpolare ($"{x:D2}"). Locul exact e linia cu formatarea, chiar dacă valoarea vine de departe.
Reparații tipice:
- zerouri în față la o valoare zecimală:
x.ToString("00.00")sau convertești laintși foloseștiD2; - hexazecimal din
double:((int)x).ToString("X2"); - două zecimale:
F2sauN2.
De ce apare: cauzele frecvente
1D2 pe un decimal
decimal ora = 9m;
Console.WriteLine(ora.ToString("D2"));decimal ora = 9m;
Console.WriteLine(((int)ora).ToString("D2"));D2 adaugă zerouri doar pe tipuri întregi; după conversie afișează 09.
2Hexazecimal dintr-un double
double rosu = 255;
string hex = rosu.ToString("X2");double rosu = 255;
string hex = ((int)rosu).ToString("X2");X lucrează doar pe întregi.
3Literă care nu e format standard
Console.WriteLine($"{pret:L2}");Console.WriteLine($"{pret:F2} lei");L nu e un format; F2 dă două zecimale, iar unitatea se scrie ca text.
Repară eroarea, direct în pagină
Programul afișează ora de început a unei ședințe și culoarea ei în hexazecimal, dar se oprește cu System.FormatException: Format specifier was invalid. Repară formatările ca programul să afișeze Ora: 09:05 și Culoare: #FF8000.
double ora = 9, minut = 5;
double rosu = 255, verde = 128, albastru = 0;
Console.WriteLine($"Ora: {ora.ToString("D2")}:{minut.ToString("D2")}");
Console.WriteLine($"Culoare: #{rosu.ToString("X2")}{verde.ToString("X2")}{albastru.ToString("X2")}");Ora: 09:05 Culoare: #FF8000
Indiciu
Formatele D și X funcționează doar pe tipuri întregi.
Reparația
double ora = 9, minut = 5;
double rosu = 255, verde = 128, albastru = 0;
Console.WriteLine($"Ora: {((int)ora).ToString("D2")}:{((int)minut).ToString("D2")}");
Console.WriteLine($"Culoare: #{((int)rosu).ToString("X2")}{((int)verde).ToString("X2")}{((int)albastru).ToString("X2")}");De ce merge
Ora, minutele și componentele culorii erau double, iar D2 și X2 sunt definite doar pentru întregi. După conversia la int, D2 adaugă zeroul din față (09, 05), iar X2 scrie fiecare componentă în hexazecimal pe două cifre (FF, 80, 00).
Alte forme ale mesajului
Unhandled exception. System.FormatException: Format specifier was invalid.
Cum o eviți pe viitor
- Folosește
F2/N2pentru sume șiD2doar pentru întregi (ore, minute, numere de ordine). - Pentru formate speciale scrie un format personalizat cu
0și#("000.00","#,##0.00"). - Testează formatarea cu valori reale ale tipului folosit în program, nu doar cu literale
int.
Întrebări frecvente
De ce merge 5.ToString("D2") și nu 5.0.ToString("D2")?
5 e int, deci acceptă D. 5.0 e double, iar formatul D nu e definit pentru tipurile cu virgulă.
E aceeași eroare ca Input string was not in a correct format?
Nu. Aceea apare la citirea unui număr dintr-un text (int.Parse) sau la un șir de format cu acolade greșite. Aceasta apare când litera de format nu se potrivește cu tipul valorii.
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: Index (zero based) must be greater than or equal to zero and less than the size of the argument list. În textul de format al lui `string.Format` sau `Console.WriteLine("...{1}...", x)` ai un indice (`{1}`, `{2}`) pentru care nu ai trimis argument. Indicii încep de la 0: cu două argumente poți folosi doar `{0}` și `{1}`. Adaugă argumentul lipsă sau corectează indicele; și mai simplu, folosește interpolarea `$"..."`. error CS0266: Cannot implicitly convert type 'double' to 'int'. An explicit conversion exists (are you missing a cast?) Pui un `double` într-un `int`, iar conversia ar pierde zecimalele, deci C# nu o face automat. Decide ce vrei: cast explicit `(int)x` (taie zecimalele), `(int)Math.Round(x)` (rotunjește) sau schimbă tipul variabilei în `double`. Î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.
