1. Introducción
Cuando trabajas con archivos usando FileStream u otras clases de streams, es súper importante entender de antemano qué va a pasar con el archivo cuando intentes abrirlo. Muchas veces pasa que el archivo ya existe y quieres o bien añadir nuevos datos sin perder lo anterior, o sobrescribir el archivo por completo. Por otro lado, hay momentos en los que el archivo aún no existe y quieres leerlo, sin arriesgarte a crear un archivo vacío por accidente.
Por ejemplo, si estás programando un bloc de notas para apuntes diarios, tu tarea es añadir nuevas entradas al final de un archivo ya existente, guardando todo lo que se escribió antes. Eso significa que tienes que abrir el archivo en modo de añadir. En otro caso — digamos que tienes un archivo de log que debe crearse de nuevo cada vez que arranca la app, para no mezclar datos viejos. Aquí tienes que abrir el archivo de forma que se limpie o se cree de cero si no existe. Y si tu tarea es solo leer un archivo existente, seguramente querrás asegurarte de no crear uno nuevo si no está, porque podrías acabar con un archivo vacío donde no debería haber nada.
Todas estas situaciones — añadir, sobrescribir, leer sin crear — se resuelven en C# usando modos especiales de apertura de archivos, que se definen con la enumeración System.IO.FileMode. Cada modo controla el comportamiento al abrir o crear un archivo, ayudándote a tener el control total sobre lo que pasa cuando interactúas con él.
2. Enumeración FileMode — explicado fácil
Aquí tienes los valores principales de la enumeración FileMode:
| Valor | Descripción | Si el archivo existe | Si el archivo NO existe |
|---|---|---|---|
|
Crea un archivo nuevo. Si ya existe — lanza una excepción | Error | Ok, archivo creado |
|
Crea un archivo nuevo si no existe, o sobrescribe el existente | Sobrescribe | Ok, crea |
|
Abre un archivo existente. Si no existe — excepción | Ok, abre | Error |
|
Abre si existe, si no — crea uno nuevo | Ok, abre | Ok, crea |
|
Abre un archivo existente y pone su longitud a cero (borra el contenido) | Ok, limpia el archivo | Error |
|
Abre el archivo para añadir al final, si no existe — crea uno nuevo | Ok, añade al final | Ok, crea |
Ilustración: Escenarios de comportamiento
flowchart TD
Start[Inicio]
A{¿El archivo existe?}
B1[Abrir para añadir]
B2[Crear archivo nuevo]
B3[Sobrescribir archivo]
B4[Abrir archivo]
B5[Error: archivo no encontrado]
B6[Error: el archivo ya existe]
Start --> A
A --Append, OpenOrCreate--> B1
A --Create, Truncate--> B3
A --Open, Truncate--> B4
A --CreateNew--> B6
A --Create, OpenOrCreate, Append--> B2
A --Open, Truncate--> B5
3. Ejemplos de apertura de archivos en diferentes modos
Vamos a probar todo esto en la práctica con nuestra mini-app que estamos desarrollando durante el curso. Supón que tienes un archivo de texto donde escribimos saludos y la fecha de acceso. Vamos a ver tres escenarios típicos:
- A. Creamos un archivo nuevo (CreateNew)
- B. Sobrescribimos el archivo (Create)
- C. Añadimos líneas al final del archivo (Append)
Crear un archivo nuevo (FileMode.CreateNew)
Si el archivo ya existe, este modo garantiza que no se podrá crear de nuevo: el programa lanzará una excepción IOException. Esto es útil si no puedes perder datos o borrar archivos ajenos por accidente.
using System;
using System.IO;
string filePath = "greeting.txt";
// Intentamos crear un archivo nuevo — si ya existe, habrá excepción!
try
{
var stream = new FileStream(filePath, FileMode.CreateNew, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine("¡Hola! Este es el primer registro.");
writer.WriteLine($"Fecha: {DateTime.Now}");
Console.WriteLine("Archivo creado con éxito.");
writer.Close();
}
catch (IOException)
{
Console.WriteLine($"¡El archivo '{filePath}' ya existe! No lo vamos a sobrescribir.");
}
Ojo: si ejecutas este código una segunda vez — el catch saltará y los datos no se borrarán.
Sobrescribir el archivo (FileMode.Create)
Este modo no se anda con rodeos: si el archivo ya existe, se limpia por completo. Si no — simplemente se crea uno nuevo. Es útil cuando quieres empezar "desde cero" cada vez. Por ejemplo, para guardar un informe.
using System;
using System.IO;
string filePath = "greeting.txt";
// Crear o sobrescribir completamente el archivo
var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine("¡Hola! He actualizado el archivo por completo :)");
writer.WriteLine($"Actualizado: {DateTime.Now}");
Console.WriteLine("Archivo creado o sobrescrito.");
writer.Close();
Ejecuta este código varias veces — en el archivo siempre estarán solo las últimas líneas añadidas. Todo lo viejo desaparece sin dejar rastro.
Añadir al final del archivo (FileMode.Append)
Un modo genial para logs, registros de eventos, control de visitas, etc. Si el archivo no existe — se crea. Si existe — los datos se añaden al final.
using System;
using System.IO;
string filePath = "greeting.txt";
// Añadir una nueva línea al final del archivo
var stream = new FileStream(filePath, FileMode.Append, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine($"¡Otro saludo! Fecha: {DateTime.Now}");
Console.WriteLine("Añadida una nueva línea al final del archivo.");
writer.Close();
Prueba a ejecutar este código muchas veces seguidas. El archivo irá creciendo, cada nuevo registro aparecerá al final.
4. ¿Cómo elegir el modo de apertura de archivo? Consejos prácticos
Escenarios de la vida real:
- Logs: casi siempre usa Append. Perder logs por sobrescribir — dolor para el admin y regalo para el villano.
- Exportar informe: normalmente se usa Create, para no llenar la carpeta de versiones viejas.
- Exportar datos críticos: aquí va bien CreateNew. Si el archivo existe — error, no tocamos nada.
- Leer archivo: aquí no necesitas modo de creación, usa FileMode.Open — si el archivo no está, es señal de problema.
Al programar en C# se usan a menudo los métodos estáticos de la clase File, que por dentro eligen el modo adecuado. Por ejemplo, File.AppendAllText siempre usa Append, y File.WriteAllText — Create.
5. Modos de archivo y problemas al trabajar
Algunos detalles traicioneros:
Si abres un archivo con FileMode.Create o FileMode.Truncate, todo el contenido se borra. Ten cuidado — la pérdida accidental de datos le ha pasado no solo a estudiantes, sino también a programadores con mucha experiencia.
Si intentas abrir un archivo que no existe usando FileMode.Open o FileMode.Truncate, tendrás FileNotFoundException. No olvides comprobar que el archivo existe con File.Exists(path).
Con el modo Append solo puedes escribir. Si necesitas leer y escribir, mira otros modos (OpenOrCreate + el FileAccess adecuado).
Ejemplo: Leer y escribir
A veces quieres leer y escribir en el archivo (por ejemplo, abres una cuenta bancaria — quieres ingresar dinero y comprobar el saldo). Usa FileMode.OpenOrCreate:
using System.IO;
string filePath = "balance.txt";
// Abrir archivo para leer y escribir; si no existe — crear
var stream = new FileStream(filePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);
// Aquí puedes leer y escribir
6. Detalles útiles
Modos de apertura de archivo
graph TD
A[Solicitar archivo] --> B[Elegir modo]
B --> C1[CreateNew] -->|Si el archivo existe| D1[Error]
C1 -->|El archivo no existe| E1[Crear]
B --> C2[Create] -->|Siempre| F1[Crear/Sobrescribir]
B --> C3[Open] -->|El archivo existe| G1[Abrir]
C3 -->|El archivo no existe| D1
B --> C4[OpenOrCreate] -->|El archivo existe| G1
C4 -->|El archivo no existe| E1
B --> C5[Append] -->|El archivo existe| H1[Abrir para añadir]
C5 -->|El archivo no existe| E1
B --> C6[Truncate] -->|El archivo existe| I1[Limpiar]
C6 -->|El archivo no existe| D1
Tabla resumen de modos de apertura
| FileMode | Archivo existe | Archivo NO existe | Acceso a datos | ¿Borra el contenido viejo? |
|---|---|---|---|---|
|
Excepción | Crea nuevo | Escribe | N/A |
|
Sobrescribe | Crea nuevo | Escribe | Sí |
|
Abre | Excepción | Lee/escribe | No |
|
Abre | Crea nuevo | Lee/escribe | No |
|
Limpia | Excepción | Escribe | Sí |
|
Abre para escribir al final | Crea nuevo | Solo escribe | No (añade) |
Comparación con métodos de alto nivel de la clase File
- File.WriteAllText(path, text) → por dentro usa FileMode.Create, o sea, el archivo viejo se sobrescribe.
- File.AppendAllText(path, text) → usa el modo Append, todo se añade al final.
- File.ReadAllText(path) → abre el archivo en modo lectura (FileMode.Open).
A veces estos métodos son suficientes, pero trabajar con FileStream y especificar el modo te da control total sobre lo que pasa.
Detalles según el sistema operativo
A menudo los desarrolladores no tienen en cuenta que en Windows un archivo abierto por otro proceso para escritura puede no estar disponible para abrirlo de nuevo — intentar acceder dará error. Por eso es muy importante usar bien el parámetro FileShare para gestionar el acceso compartido al archivo (de esto hablaremos más en otra lección). En diferentes sistemas operativos los mecanismos de bloqueo y permisos pueden variar, pero la idea de los modos de apertura de archivos es universal.
GO TO FULL VERSION