CodeGym /Cursos /C# SELF /Modos de apertura de archivos

Modos de apertura de archivos

C# SELF
Nivel 35, Lección 4
Disponible

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
CreateNew
Crea un archivo nuevo. Si ya existe — lanza una excepción Error Ok, archivo creado
Create
Crea un archivo nuevo si no existe, o sobrescribe el existente Sobrescribe Ok, crea
Open
Abre un archivo existente. Si no existe — excepción Ok, abre Error
OpenOrCreate
Abre si existe, si no — crea uno nuevo Ok, abre Ok, crea
Truncate
Abre un archivo existente y pone su longitud a cero (borra el contenido) Ok, limpia el archivo Error
Append
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
Escenarios de comportamiento para los diferentes modos FileMode

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
Esquema de decisión para el modo de apertura de archivo

Tabla resumen de modos de apertura

FileMode Archivo existe Archivo NO existe Acceso a datos ¿Borra el contenido viejo?
CreateNew
Excepción Crea nuevo Escribe N/A
Create
Sobrescribe Crea nuevo Escribe Sí
Open
Abre Excepción Lee/escribe No
OpenOrCreate
Abre Crea nuevo Lee/escribe No
Truncate
Limpia Excepción Escribe Sí
Append
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.

2
Tarea
C# SELF, nivel 35, lección 4
Bloqueada
Añadir al final del archivo
Añadir al final del archivo
1
Cuestionario/control
Trabajo con archivos, nivel 35, lección 4
No disponible
Trabajo con archivos
Fundamentos del trabajo con archivos en C#
Comentarios
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION