...
Eroare C# · Fișiere, HTTP, URI și JSON

System.IO.EndOfStreamException: Unable to read beyond the end of the stream.

Pe scurt

Ai citit dintr-un flux binar (`BinaryReader.ReadInt32`, `ReadString`...) mai mult decât conține. De obicei bucla nu verifică sfârșitul fișierului sau citești alte tipuri decât cele scrise. Verifică `reader.BaseStream.Position < reader.BaseStream.Length`, scrie întâi numărul de elemente sau citește exact tipurile scrise.

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

Ce înseamnă

BinaryReader citește octeți și îi interpretează după tipul cerut: ReadInt32 ia 4 octeți, ReadInt64 8, ReadDouble 8, ReadString o lungime urmată de text. Dacă în flux nu mai sunt destui octeți pentru ce ai cerut, primești System.IO.EndOfStreamException: Unable to read beyond the end of the stream..

Cauze tipice:

  • o buclă while (true) care citește până „crapă”, fără să verifice sfârșitul;
  • scrierea și citirea folosesc tipuri diferite (scrii int, citești long; scrii decimal, citești double), deci consumi mai mulți octeți decât există;
  • fișierul a fost scris incomplet (programul s-a oprit înainte de Flush / Dispose);
  • citești dintr-un MemoryStream după ce ai scris în el, dar ai uitat să-l readuci la început (Position = 0).

Pentru formate binare proprii, cel mai sigur e să scrii întâi numărul de elemente (w.Write(lista.Count)), apoi elementele, iar la citire să citești exact atâtea. Pentru fluxuri citite până la final, condiția BaseStream.Position < BaseStream.Length sau PeekChar() != -1 oprește bucla la timp.

De ce apare: cauzele frecvente

1Buclă fără condiție de sfârșit

Greșit
C#
while (true)
    Console.WriteLine(r.ReadInt32());
Corect
C#
while (r.BaseStream.Position < r.BaseStream.Length)
    Console.WriteLine(r.ReadInt32());

Bucla se oprește când s-au citit toți octeții.

2Tipuri diferite la scriere și citire

Greșit
C#
w.Write(nota);          // int, 4 octeti
long n = r.ReadInt64(); // cere 8 octeti
Corect
C#
w.Write(nota);          // int
int n = r.ReadInt32();

Citirea trebuie să folosească exact tipurile scrise, în aceeași ordine.

3Numărul de elemente scris la început

Greșit
C#
foreach (var x in note) w.Write(x);
Corect
C#
w.Write(note.Length);
foreach (var x in note) w.Write(x);
// la citire
int n = r.ReadInt32();
for (int i = 0; i < n; i++) Console.WriteLine(r.ReadInt32());

Cititorul știe câte elemente urmează și nu depășește sfârșitul.

Repară tu

Repară eroarea, direct în pagină

Programul salvează notele într-un fișier binar și le citește înapoi, dar după ultima notă se oprește cu System.IO.EndOfStreamException: Unable to read beyond the end of the stream. Repară bucla de citire ca programul să afișeze 9, 7, 10 și Note citite: 3.

Codul care dă eroarea
C#
using (var w = new BinaryWriter(File.Create("note.bin")))
{
    foreach (int nota in new[] { 9, 7, 10 })
        w.Write(nota);
}

int citite = 0;
using (var r = new BinaryReader(File.OpenRead("note.bin")))
{
    while (true)
    {
        Console.WriteLine(r.ReadInt32());
        citite++;
    }
}
Console.WriteLine($"Note citite: {citite}");
După reparație, programul afișează
9
7
10
Note citite: 3
Indiciu

Bucla trebuie să se oprească atunci când poziția din flux a ajuns la lungimea lui.

Cum o eviți pe viitor

  • Pentru formate binare proprii, scrie un antet cu versiunea și numărul de elemente.
  • Păstrează codul de scriere și cel de citire unul lângă altul, cu aceleași tipuri, în aceeași ordine.
  • Pentru date simple, preferă un format text (JSON, CSV), mai ușor de verificat și de depanat.

Întrebări frecvente

De ce StreamReader.ReadLine nu aruncă excepția asta?

Pentru că la sfârșitul fișierului ReadLine întoarce null, iar Read întoarce -1. BinaryReader nu are o valoare specială pentru „nimic”, așa că aruncă excepție.

Excepția apare la un fișier scris chiar de programul meu. De ce?

Probabil scriitorul nu a fost închis înainte de citire, deci ultimii octeți au rămas în buffer. Pune BinaryWriter în using sau apelează Flush() înainte să citești.

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.