...
Eroare C# · Excepții cu tablouri, liste, dicționare și LINQ

System.ArgumentOutOfRangeException: count ('-1') must be a non-negative value. (Parameter 'count')

Pe scurt

Ai trimis un număr negativ unei metode care cere o lungime sau un număr de elemente: `new string(' ', n)`, `PadLeft(n)`, `Substring(start, n)`, `GetRange`, `Enumerable.Range`. De obicei `n` e calculat (`latime - text.Length`) și a ieșit negativ. Limitează-l cu `Math.Max(0, n)` sau folosește o metodă care tratează singură cazul (`PadRight`).

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

Ce înseamnă

În .NET 8 și mai nou, multe metode verifică argumentele cu ArgumentOutOfRangeException.ThrowIfNegative, iar mesajul are forma count ('-1') must be a non-negative value. (Parameter 'count'): primul nume e parametrul, iar între paranteze e valoarea primită. La alte metode mesajul e mai vechi: Non-negative number required. sau Specified argument was out of the range of valid values., dar înseamnă același lucru.

Numărul negativ e aproape mereu rezultatul unui calcul:

  • new string(' ', latime - text.Length) când textul e mai lung decât coloana;
  • text.Substring(0, text.IndexOf(',')) când virgula lipsește (IndexOf întoarce -1);
  • Enumerable.Range(1, sfarsit - inceput) când capetele sunt inversate.

Ca să găsești cauza, uită-te la numele parametrului din mesaj și la linia din stiva de apeluri din codul tău, apoi afișează valoarea calculată. Reparația e fie limitarea (Math.Max(0, n)), fie tratarea cazului special înainte (if (index < 0) ...).

De ce apare: cauzele frecvente

1Spații de completare calculate negativ

Greșit
C#
string rand = nume + new string(' ', 10 - nume.Length) + "|";
Corect
C#
string rand = nume.PadRight(10) + "|";

PadRight nu taie și nu aruncă excepție dacă textul e deja mai lung.

2Substring până la un caracter care lipsește

Greșit
C#
string oras = adresa.Substring(0, adresa.IndexOf(','));
Corect
C#
int i = adresa.IndexOf(',');
string oras = i >= 0 ? adresa.Substring(0, i) : adresa;

IndexOf întoarce -1 când nu găsește caracterul; cazul se tratează separat.

3Interval cu capetele inversate

Greșit
C#
var zile = Enumerable.Range(start, sfarsit - start + 1);
Corect
C#
var zile = sfarsit >= start
    ? Enumerable.Range(start, sfarsit - start + 1)
    : Enumerable.Empty<int>();

Numărul de elemente trebuie să fie cel puțin 0.

Repară tu

Repară eroarea, direct în pagină

Programul afișează un tabel cu numele aliniate pe o coloană de 8 caractere, dar se oprește cu System.ArgumentOutOfRangeException: count ('-2') must be a non-negative value. (Parameter 'count'). Repară alinierea ca programul să afișeze Ana | 30, Dan | 25 și Alexandra| 41.

Codul care dă eroarea
C#
var persoane = new (string Nume, int Varsta)[] { ("Ana", 30), ("Dan", 25), ("Alexandra", 41) };
foreach (var p in persoane)
{
    string coloana = p.Nume + new string(' ', 8 - p.Nume.Length);
    Console.WriteLine($"{coloana}| {p.Varsta}");
}
După reparație, programul afișează
Ana     | 30
Dan     | 25
Alexandra| 41
Indiciu

Există o metodă pe string care completează cu spații și nu aruncă excepție dacă textul e deja lung.

Alte forme ale mesajului

  • System.ArgumentOutOfRangeException: length ('-1') must be a non-negative value. (Parameter 'length')
  • System.ArgumentOutOfRangeException: totalWidth ('-1') must be a non-negative value. (Parameter 'totalWidth')
  • System.ArgumentOutOfRangeException: Non-negative number required. (Parameter 'count')
  • System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values. (Parameter 'count')

Cum o eviți pe viitor

  • Când calculezi o lungime prin scădere, gândește-te ce se întâmplă dacă rezultatul e negativ.
  • Verifică rezultatul lui IndexOf înainte să-l folosești ca lungime sau poziție.
  • Pentru alinierea textului folosește PadLeft / PadRight sau alinierea din interpolare ($"{nume,-10}").

Întrebări frecvente

Cum aflu ce valoare negativă a primit metoda?

Uită-te în mesaj: în .NET 8+ valoarea apare între paranteze, de exemplu count ('-3'). În versiunile mai vechi, mesajul poate avea un rând Actual value was -3..

Ce face alinierea din interpolare?

$"{nume,-10}|" completează textul cu spații până la 10 caractere, aliniat la stânga (cu 10 pozitiv, la dreapta). Dacă textul e mai lung, rămâne întreg, fără excepție.

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.