System.ArgumentException: 'windows-1250' is not a supported encoding name. For information on defining a custom encoding, see the documentation for the Encoding.RegisterProvider method. (Parameter 'name')
În .NET (Core / 5+) sunt disponibile implicit doar câteva codificări (UTF-8, UTF-16, ASCII, Latin-1). Pentru codificările vechi Windows, precum `windows-1250` (folosită des la fișiere CSV cu diacritice) sau `windows-1252`, înregistrează întâi furnizorul: `Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În .NET Framework toate codificările Windows erau disponibile direct. În .NET modern, pentru a păstra runtime-ul mic, sunt incluse implicit doar UTF-8, UTF-16, UTF-32, ASCII și ISO-8859-1 (Latin-1). Când ceri altă codificare cu Encoding.GetEncoding("windows-1250") sau Encoding.GetEncoding(1250), primești ArgumentException: 'windows-1250' is not a supported encoding name. For information on defining a custom encoding, see the documentation for the Encoding.RegisterProvider method..
În România eroarea apare des la importul de fișiere CSV exportate din programe mai vechi sau din Excel, salvate în windows-1250 (Europa Centrală), unde diacriticele nu sunt în UTF-8.
Reparația are două părți:
- o dată, la pornirea aplicației:
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);(clasa e înSystem.Text, inclusă în .NET; în proiecte .NET Standard e nevoie de pachetulSystem.Text.Encoding.CodePages); - apoi
Encoding.GetEncoding(1250)funcționează, inclusiv înFile.ReadAllText(cale, codificare)șinew StreamReader(cale, codificare).
Dacă poți alege formatul fișierului, folosește UTF-8: nu mai ai nevoie de codificări vechi.
De ce apare: cauzele frecvente
1Codificare Windows cerută fără furnizor
var enc = Encoding.GetEncoding("windows-1250");
string text = File.ReadAllText("clienti.csv", enc);Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
var enc = Encoding.GetEncoding("windows-1250");
string text = File.ReadAllText("clienti.csv", enc);Furnizorul adaugă codificările Windows la cele disponibile.
2Număr de pagină de cod
var enc = Encoding.GetEncoding(1252);Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
var enc = Encoding.GetEncoding(1252);Aceeași regulă se aplică și când ceri codificarea după număr.
3Fișierul poate fi salvat în UTF-8
File.WriteAllText("export.csv", text, Encoding.GetEncoding(1250));File.WriteAllText("export.csv", text, new UTF8Encoding(true));UTF-8 cu BOM e recunoscut corect și de Excel și nu cere furnizor suplimentar.
Repară eroarea, direct în pagină
Programul decodează un rând dintr-un fișier CSV vechi salvat în windows-1250, dar se oprește cu System.ArgumentException: 'windows-1250' is not a supported encoding name. Repară programul ca să afișeze Rand: Ana;Iasi;30.
using System.Text;
byte[] octeti = { 0x41, 0x6E, 0x61, 0x3B, 0x49, 0x61, 0x73, 0x69, 0x3B, 0x33, 0x30 };
var codificare = Encoding.GetEncoding("windows-1250");
Console.WriteLine($"Rand: {codificare.GetString(octeti)}");Rand: Ana;Iasi;30
Indiciu
Codificările Windows trebuie înregistrate printr-un furnizor înainte de a fi folosite.
Reparația
using System.Text;
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
byte[] octeti = { 0x41, 0x6E, 0x61, 0x3B, 0x49, 0x61, 0x73, 0x69, 0x3B, 0x33, 0x30 };
var codificare = Encoding.GetEncoding("windows-1250");
Console.WriteLine($"Rand: {codificare.GetString(octeti)}");De ce merge
În .NET modern codificările Windows nu sunt disponibile implicit. Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) le adaugă, iar apoi Encoding.GetEncoding("windows-1250") întoarce codificarea cerută. Octeții din exemplu sunt litere fără diacritice, deci rezultatul decodării e Ana;Iasi;30. Într-un fișier real cu diacritice, aceeași codificare le-ar transforma corect în ă, î, ș și ț.
Alte forme ale mesajului
System.ArgumentException: 'windows-1252' is not a supported encoding name. For information on defining a custom encoding, see the documentation for the Encoding.RegisterProvider method. (Parameter 'name')System.NotSupportedException: No data is available for encoding 1250. For information on defining a custom encoding, see the documentation for the Encoding.RegisterProvider method.
Cum o eviți pe viitor
- Înregistrează
CodePagesEncodingProvidero singură dată, la începutul programului, dacă lucrezi cu fișiere vechi. - Pentru fișierele pe care le creezi tu folosește UTF-8.
- Când primești fișiere de la alții, stabilește codificarea împreună cu ei, nu o ghici.
- Testează importul cu un fișier care conține diacritice reale, nu doar text ASCII.
Întrebări frecvente
De ce diacriticele apar ca semne de întrebare sau caractere ciudate?
Pentru că fișierul e citit cu altă codificare decât cea în care a fost scris (de exemplu un fișier windows-1250 citit ca UTF-8). Citește-l cu codificarea reală, după ce ai înregistrat furnizorul.
Care e diferența dintre windows-1250 și ISO-8859-2?
Ambele acoperă limbile din Europa Centrală, inclusiv româna, dar au mici diferențe de poziție pentru unele caractere. Excel și programele Windows folosesc de obicei windows-1250.
Erori înrudite
System.IO.FileNotFoundException: Could not find file 'C:\Proiecte\Magazin\bin\Debug\net9.0\config.json'. Fișierul pe care vrei să-l citești nu există la calea folosită. De cele mai multe ori calea e relativă și se rezolvă față de folderul din care rulează programul (`bin/Debug/net9.0`), nu față de folderul proiectului. Verifică cu `File.Exists`, folosește o cale corectă sau copiază fișierul la build. System.Globalization.CultureNotFoundException: Only the invariant culture is supported in globalization-invariant mode. See https://aka.ms/GlobalizationInvariantMode for more information. (Parameter 'name') Aplicația rulează în modul „globalization-invariant” (de obicei în Docker sau pe Linux fără biblioteca ICU), iar codul cere o cultură concretă, de exemplu `new CultureInfo("ro-RO")`. Instalează ICU în imagine și setează `InvariantGlobalization` pe `false`, sau formatează fără cultură, cu un `NumberFormatInfo` propriu. 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. Î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.
