error CS0031: Constant value '300' cannot be converted to a 'byte'
Ai pus o valoare constantă care nu încape în tipul variabilei, de exemplu 300 într-un `byte` (0–255) sau -1 într-un `uint`. Alege un tip suficient de mare (`int`, `long`) sau o valoare din intervalul tipului.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare tip numeric are un interval: byte 0–255, sbyte -128–127, short -32768–32767, ushort 0–65535, int aproximativ ±2,1 miliarde, uint 0–4,29 miliarde. Când scrii o constantă (un număr literal sau un const) care iese din interval, compilatorul vede problema chiar la compilare și dă CS0031, numind valoarea și tipul.
Asta te protejează: dacă valoarea nu ar fi constantă, ar trebui un cast explicit, iar rezultatul ar fi „trunchiat” fără avertisment (300 ar deveni 44 în byte).
Cauze frecvente: alegi byte pentru „numere mici”, dar valoarea reală depășește 255; pui un număr negativ într-un tip fără semn (uint, ulong, byte); sau scrii un cast forțat al unei constante ((byte)300), care dă tot CS0221 la compilare.
De ce apare: cauzele frecvente
1Valoare mai mare decât încape în byte
byte procent = 300;int procent = 300;byte merge până la 255. Pentru valori mai mari, int e alegerea obișnuită.
2Număr negativ într-un tip fără semn
uint sold = -50;int sold = -50;uint nu are valori negative. Un sold poate fi negativ, deci are nevoie de un tip cu semn.
Repară eroarea, direct în pagină
Programul ține scorul maxim al unui joc și numărul de vieți, dar nu compilează: error CS0031: Constant value '1500' cannot be converted to a 'byte'. Alege un tip potrivit pentru scor, astfel încât programul să afișeze scorul după bonus și viețile rămase.
byte scor = 1500;
byte vieti = 3;
scor += 250;
vieti--;
Console.WriteLine($"Scor: {scor}");
Console.WriteLine($"Vieti: {vieti}");Scor: 1750 Vieti: 2
Indiciu
Scorul depășește 255, deci nu încape într-un byte.
Reparația
int scor = 1500;
byte vieti = 3;
scor += 250;
vieti--;
Console.WriteLine($"Scor: {scor}");
Console.WriteLine($"Vieti: {vieti}");De ce merge
byte acceptă doar valori între 0 și 255, așa că literalul 1500 nu putea fi pus în variabila scor. Cu int, scorul încape fără probleme, iar adunarea bonusului dă 1750. vieti rămâne byte, pentru că 3 e în interval. Restul programului nu se schimbă.
Alte forme ale mesajului
error CS0031: Constant value '-1' cannot be converted to a 'uint'error CS0031: Constant value '70000' cannot be converted to a 'short'error CS0221: Constant value '300' cannot be converted to a 'byte' (use 'unchecked' syntax to override)
Cum o eviți pe viitor
- Folosește
intpentru numere întregi obișnuite șilongpentru valori foarte mari (milisecunde, ID-uri mari). Tipurile mici (byte,short) au sens doar la date binare sau la structuri cu memorie limitată. - Nu folosi tipuri fără semn pentru valori care pot deveni negative (diferențe, solduri).
- Pentru bani folosește
decimal. - Consultă
byte.MaxValue,int.MaxValuecând nu ești sigur de interval.
Întrebări frecvente
De ce byte b = 255; merge, dar byte b = x; (cu int x = 255) nu?
Pentru constante compilatorul verifică intervalul și permite conversia. Pentru o variabilă int nu știe valoarea la compilare, deci cere un cast explicit (CS0266).
Ce se întâmplă la (byte)x dacă x e 300?
Fără checked, rezultatul este 44 (se păstrează doar ultimii 8 biți). Cu checked((byte)x) primești OverflowException la rulare.
Erori înrudite
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`. System.OverflowException: Value was either too large or too small for an Int32. Numărul pe care încerci să-l citești sau să-l convertești nu încape în tipul cerut: un `int` ține valori doar între -2.147.483.648 și 2.147.483.647. Folosește un tip mai mare (`long`, `decimal`) sau validează valoarea înainte. error CS0664: Literal of type double cannot be implicitly converted to type 'decimal'; use an 'M' suffix to create a literal of this type Un număr cu zecimale scris simplu (`19.99`) este `double`, iar într-o variabilă `decimal` trebuie scris cu sufixul `m`: `19.99m`. Adaugă `m` (sau `M`) după fiecare literal cu zecimale pus într-un `decimal`. Î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.
