System.ArgumentOutOfRangeException: count ('-1') must be a non-negative value. (Parameter 'count')
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
string rand = nume + new string(' ', 10 - nume.Length) + "|";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
string oras = adresa.Substring(0, adresa.IndexOf(','));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
var zile = Enumerable.Range(start, sfarsit - start + 1);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ă 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.
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}");
}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.
Reparația
var persoane = new (string Nume, int Varsta)[] { ("Ana", 30), ("Dan", 25), ("Alexandra", 41) };
foreach (var p in persoane)
{
string coloana = p.Nume.PadRight(8);
Console.WriteLine($"{coloana}| {p.Varsta}");
}De ce merge
8 - nume.Length devenea -1 pentru Alexandra, care are 9 litere, iar new string(' ', -1) nu e permis. PadRight(8) completează cu spații până la 8 caractere, iar dacă textul e mai lung îl lasă neschimbat. Numele scurte rămân aliniate, iar cel lung e afișat întreg, lipit de separator, fără excepție.
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/PadRightsau 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
System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. (Parameter 'index') Ai accesat într-o listă (`List<T>`) un indice care nu există: negativ sau mai mare ori egal cu `Count`. Indicii valizi sunt de la 0 la `Count - 1`; verifică bucla (`i < lista.Count`) și dacă lista are elementele la care te aștepți. System.ArgumentOutOfRangeException: Index must be within the bounds of the List. (Parameter 'index') Ai apelat `List.Insert(index, ...)` cu un index mai mare decât numărul de elemente (sau negativ). La `Insert` indexul poate fi între `0` și `Count` inclusiv (`Count` = adaugă la final). Verifică indexul, scade 1 dacă pornești numărătoarea de la 1, sau folosește `Add` pentru final. System.ArgumentException: Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection. Ai cerut dintr-o listă mai multe elemente decât există de la poziția de start până la final, de obicei cu `GetRange(start, numar)` sau `RemoveRange(start, numar)` la ultima pagină. Limitează numărul: `Math.Min(numar, lista.Count - start)`, sau folosește `Skip(start).Take(numar)`, care nu aruncă excepții. Î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.
