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

System.InvalidCastException: Unable to cast object of type 'System.String' to type 'System.Int32'.

Pe scurt

Ai făcut un cast `(Tip)obiect`, dar obiectul este de fapt de alt tip: aici un `string` „îmbrăcat” în `object`, tratat ca `int`. Verifică tipul înainte cu `is` (pattern matching) sau convertește corect (`int.Parse`, `Convert.ToInt32`).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când o valoare stă într-o variabilă de un tip general (object, o interfață sau o clasă de bază), un cast (int)valoare sau (Caine)animal îi spune runtime-ului: „știu că aici e de fapt un int”. Runtime-ul verifică la rulare, iar dacă obiectul real e de alt tip, aruncă InvalidCastException. Mesajul arată ambele tipuri cu numele complete din .NET: tipul real al obiectului (System.String) și tipul cerut (System.Int32).

Compilatorul nu poate prinde eroarea, pentru că vede doar tipul declarat (object), iar cast-ul de la object la int este, în principiu, posibil.

Cazuri frecvente: valori citite dintr-o colecție de object sau dintr-un Dictionary<string, object> (de exemplu date din JSON); un int „boxed” convertit la long ((long)(object)5 aruncă, deși 5 încape în long, pentru că unboxing-ul cere exact tipul original); obiecte dintr-o ierarhie convertite la clasa derivată greșită ((Caine)new Pisica()).

Soluția sigură este pattern matching: if (valoare is int n) sau operatorul as pentru clase.

De ce apare: cauzele frecvente

1Text tratat ca număr

Greșit
C#
object valoare = "42";
int n = (int)valoare;
Corect
C#
object valoare = "42";
int n = valoare is int i ? i : int.Parse(valoare.ToString());

Obiectul e un string, deci cast-ul la int eșuează. Se verifică tipul și, pentru text, se parsează.

2Unboxing la alt tip numeric

Greșit
C#
object o = 5;
long l = (long)o;
Corect
C#
object o = 5;
long l = (int)o;

Un int pus în object poate fi scos (unboxing) doar ca int. După aceea, conversia int → long se face implicit.

3Clasă derivată greșită

Greșit
C#
Animal a = new Pisica();
Caine c = (Caine)a;

class Animal { }
class Caine : Animal { }
class Pisica : Animal { }
Corect
C#
Animal a = new Pisica();
if (a is Caine c)
    Console.WriteLine("Caine");
else
    Console.WriteLine("Nu e caine");

class Animal { }
class Caine : Animal { }
class Pisica : Animal { }

is Caine c verifică tipul și face conversia doar dacă reușește, fără excepție.

Repară tu

Repară eroarea, direct în pagină

Programul primește setările unei aplicații ca valori object (ca dintr-un fișier de configurare), dar la rulare primești System.InvalidCastException: Unable to cast object of type 'System.String' to type 'System.Int32'. Repară citirea cu pattern matching, astfel încât valorile int să fie folosite direct, iar cele text să fie parsate.

Codul care dă eroarea
C#
var setari = new Dictionary<string, object>
{
    ["port"] = 8080,
    ["timeout"] = "30",
    ["incercari"] = 3
};

foreach (var (cheie, v) in setari)
{
    int valoare = (int)v;
    Console.WriteLine($"{cheie} = {valoare}");
}
După reparație, programul afișează
port = 8080
timeout = 30
incercari = 3
Indiciu

Folosește v is int n ? n : int.Parse((string)v) sau un switch pe tip.

Alte forme ale mesajului

  • System.InvalidCastException: Unable to cast object of type 'System.Int32' to type 'System.Int64'.
  • System.InvalidCastException: Unable to cast object of type 'Pisica' to type 'Caine'.

Cum o eviți pe viitor

  • Evită colecțiile de object: folosește generice (List<int>, Dictionary<string, decimal>) și tipul e garantat la compilare.
  • Când tipul nu e sigur, folosește is cu pattern matching sau switch pe tip, nu cast direct.
  • Pentru conversii între tipuri diferite (text în număr), folosește Parse/TryParse/Convert, nu cast.
  • La ierarhii de clase, preferă metodele virtual în locul cast-urilor la clasa derivată.

Întrebări frecvente

Ce diferență e între (Caine)a și a as Caine?

Cast-ul aruncă InvalidCastException dacă tipul nu se potrivește. as întoarce null în acel caz (și funcționează doar cu tipuri referință sau nullable). Varianta modernă e if (a is Caine c).

De ce (long)(object)5 aruncă, dacă 5 încape în long?

Pentru că scoaterea unei valori din object (unboxing) trebuie să folosească exact tipul cu care a fost pusă acolo, int. Abia după unboxing poți converti la long: (long)(int)o.

Ce diferență e față de CS0030?

CS0030 apare la compilare, când compilatorul știe deja că tipurile nu au nicio legătură (de exemplu (int)"42"). InvalidCastException apare la rulare, când tipul declarat e general (object) și abia obiectul real nu se potrivește.

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.