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

System.IO.IOException: The file 'C:\Proiecte\Magazin\backup\raport.txt' already exists.

Pe scurt

Ai copiat sau mutat un fișier (`File.Copy`, `File.Move`, `FileInfo.CopyTo`) într-o destinație care există deja. Implicit .NET nu suprascrie. Trimite `overwrite: true` (`File.Copy(sursa, dest, true)`), șterge întâi destinația sau alege un nume unic.

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

Ce înseamnă

File.Copy(sursa, destinatie) și File.Move(sursa, destinatie) refuză să suprascrie un fișier existent, ca să nu pierzi date din greșeală. Dacă destinația există, primești System.IO.IOException: The file '...' already exists., cu calea completă a destinației.

Situații tipice:

  • un backup care rulează a doua oară cu același nume de fișier;
  • un program care exportă raportul zilnic și îl mută într-un dosar unde există deja raportul de ieri cu același nume;
  • testele care creează fișiere și nu le șterg după rulare.

Reparații:

  • File.Copy(sursa, destinatie, overwrite: true) și File.Move(sursa, destinatie, overwrite: true) (din .NET Core 3.0);
  • nume unic: data și ora în nume (raport-2025-03-01.txt) sau un contor;
  • verificare cu File.Exists(destinatie) și decizie explicită (păstrezi, suprascrii, redenumești).

Aceeași clasă de excepție, IOException, apare și pentru alte probleme de fișiere (fișier blocat, disc plin), deci citește mereu mesajul complet.

De ce apare: cauzele frecvente

1Backup repetat cu același nume

Greșit
C#
File.Copy("raport.txt", "raport-backup.txt");
Corect
C#
File.Copy("raport.txt", "raport-backup.txt", overwrite: true);

Cu overwrite: true, copia veche e înlocuită.

2Mutare într-un dosar cu fișier existent

Greșit
C#
File.Move("export.csv", "arhiva/export.csv");
Corect
C#
File.Move("export.csv", $"arhiva/export-{DateTime.Now:yyyyMMdd-HHmmss}.csv");

Un nume cu data și ora nu se suprapune cu exporturile anterioare.

3Decizie explicită

Greșit
C#
File.Copy(sursa, dest);
Corect
C#
if (File.Exists(dest))
    Console.WriteLine($"{dest} exista deja, il pastrez");
else
    File.Copy(sursa, dest);

Programul decide ce face, în loc să se oprească cu excepție.

Repară tu

Repară eroarea, direct în pagină

Programul face backup unui raport înainte și după actualizare, dar la a doua copiere se oprește cu System.IO.IOException: The file '.../raport-backup.txt' already exists. Repară copierea ca programul să afișeze Backup: Vanzari: 1500.

Codul care dă eroarea
C#
File.WriteAllText("raport.txt", "Vanzari: 1200");
File.Copy("raport.txt", "raport-backup.txt");

File.WriteAllText("raport.txt", "Vanzari: 1500");
File.Copy("raport.txt", "raport-backup.txt");

Console.WriteLine($"Backup: {File.ReadAllText("raport-backup.txt")}");
După reparație, programul afișează
Backup: Vanzari: 1500
Indiciu

File.Copy are un parametru care permite înlocuirea destinației.

Alte forme ale mesajului

  • System.IO.IOException: The file '/home/ana/backup/raport.txt' already exists.

Cum o eviți pe viitor

  • Decide de la început politica pentru fișiere existente: suprascrii, păstrezi sau creezi nume unic.
  • Pentru exporturi și backup-uri, pune data și ora în numele fișierului.
  • În teste, lucrează într-un dosar temporar (Path.GetTempPath()) și șterge-l la final.
  • Scrie în log ce fișier ai suprascris, ca să poți reconstitui ce s-a întâmplat.

Întrebări frecvente

File.WriteAllText suprascrie fișierul?

Da. File.WriteAllText și File.WriteAllLines creează fișierul sau îl suprascriu fără excepție. Doar Copy și Move refuză implicit suprascrierea.

Există riscuri la overwrite: true?

Pierzi conținutul vechi al destinației. Dacă e un fișier important, fă întâi o copie cu alt nume sau verifică dacă e chiar fișierul pe care vrei să-l înlocuieș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.