File Clase

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

File.cs

Proporciona métodos estáticos para la creación, copia, eliminación, movimiento y apertura de un único archivo, y ayuda a la creación de objetos FileStream.

public ref class File abstract sealed

public static class File

type File = class

Public Class File

Herencia

Object

File

Ejemplos

En el ejemplo siguiente se muestra cómo usar la clase File para comprobar si existe un archivo y, en función del resultado, crear un nuevo archivo y escribir en él, o abrir el archivo existente y leerlo. Antes de ejecutar el código, cree una carpeta c:\temp.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if (  !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)(sw);
      }
   }

   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)(sr);
   }

   try
   {
      String^ path2 = String::Concat( path, "temp" );
      
      // Ensure that the target does not exist.
      File::Delete( path2 );
      
      // Copy the file.
      File::Copy( path, path2 );
      Console::WriteLine( "{0} was copied to {1}.", path, path2 );
      
      // Delete the newly created file.
      File::Delete( path2 );
      Console::WriteLine( "{0} was successfully deleted.", path2 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s;
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "And"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Using sw As StreamWriter = File.CreateText(path)
                sw.WriteLine("Hello")
                sw.WriteLine("And")
                sw.WriteLine("Welcome")
           End Using
        End If

        ' Open the file to read from.
        Using sr As StreamReader = File.OpenText(path)
            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
        End Using
    End Sub
End Class

Comentarios

Use la clase File para operaciones típicas como copiar, mover, cambiar el nombre, crear, abrir, eliminar y anexar a un único archivo a la vez. También puede usar la clase File para obtener y establecer atributos de archivo o DateTime información relacionada con la creación, el acceso y la escritura de un archivo. Si desea realizar operaciones en varios archivos, consulte Directory.GetFiles o DirectoryInfo.GetFiles.

Muchos de los métodos File devuelven otros tipos de E/S al crear o abrir archivos. Puede usar estos otros tipos para manipular aún más un archivo. Para obtener más información, vea miembros de File específicos, como OpenText, CreateTexto Create.

Dado que todos los métodos File son estáticos, si desea realizar solo una acción, puede ser más eficaz usar un método File que un método de instancia de FileInfo correspondiente. Todos los métodos File requieren la ruta de acceso al archivo que está manipulando.

Los métodos estáticos de la clase File realizan comprobaciones de seguridad en todos los métodos. Si va a reutilizar un objeto varias veces, considere la posibilidad de usar el método de instancia correspondiente de FileInfo en su lugar, ya que la comprobación de seguridad no siempre será necesaria.

De forma predeterminada, se concede acceso completo de lectura y escritura a los nuevos archivos a todos los usuarios.

En la tabla siguiente se describen las enumeraciones que se usan para personalizar el comportamiento de varios métodos de File.

Enumeración	Descripción
FileAccess	Especifica el acceso de lectura y escritura a un archivo.
FileShare	Especifica el nivel de acceso permitido para un archivo que ya está en uso.
FileMode	Especifica si el contenido de un archivo existente se conserva o sobrescribe, y si las solicitudes para crear un archivo existente provocan una excepción.

Nota

En los miembros que aceptan una ruta de acceso como una cadena de entrada, esa ruta de acceso debe tener un formato correcto o se produce una excepción. Por ejemplo, si una ruta de acceso está completa pero comienza con un espacio, la ruta de acceso no se recorta en métodos de la clase . Por lo tanto, la ruta de acceso tiene un formato incorrecto y se genera una excepción. De forma similar, una ruta de acceso o una combinación de rutas de acceso no se puede calificar completamente dos veces. Por ejemplo, "c:\temp c:\windows" también genera una excepción en la mayoría de los casos. Asegúrese de que las rutas de acceso están bien formadas cuando se usan métodos que aceptan una cadena de ruta de acceso.

En los miembros que aceptan una ruta de acceso, la ruta de acceso puede hacer referencia a un archivo o simplemente a un directorio. La ruta de acceso especificada también puede hacer referencia a una ruta de acceso relativa o a una ruta de acceso de convención de nomenclatura universal (UNC) para un servidor y un nombre de recurso compartido. Por ejemplo, todas las siguientes son rutas de acceso aceptables:

• "c:\\\MyDir\\\MyFile.txt" en C#, o "c:\MyDir\MyFile.txt" en Visual Basic.
• "c:\\\MyDir" en C#, o "c:\MyDir" en Visual Basic.
• "MyDir\\\MySubdir" en C#, o "MyDir\MySubDir" en Visual Basic.
• "\\\\\\\MyServer\\\MyShare" en C#, o "\\\MyServer\MyShare" en Visual Basic.

Para obtener una lista de las tareas comunes de E/S, consulte Tareas de E/S comunes.

Métodos

AppendAllLines(String, IEnumerable<String>)	Anexa líneas a un archivo y, a continuación, cierra el archivo. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en el archivo y, a continuación, cierra el archivo.
AppendAllLines(String, IEnumerable<String>, Encoding)	Anexa líneas a un archivo mediante una codificación especificada y, a continuación, cierra el archivo. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en el archivo y, a continuación, cierra el archivo.
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Anexa de forma asincrónica líneas a un archivo y, a continuación, cierra el archivo. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en el archivo y, a continuación, cierra el archivo.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Anexa de forma asincrónica líneas a un archivo mediante una codificación especificada y, a continuación, cierra el archivo. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en el archivo y, a continuación, cierra el archivo.
AppendAllText(String, String)	Abre un archivo, anexa la cadena especificada al archivo y, a continuación, cierra el archivo. Si el archivo no existe, este método crea un archivo, escribe la cadena especificada en el archivo y, a continuación, cierra el archivo.
AppendAllText(String, String, Encoding)	Anexa la cadena especificada al archivo mediante la codificación especificada, creando el archivo si aún no existe.
AppendAllTextAsync(String, String, CancellationToken)	Abre de forma asincrónica un archivo o crea un archivo si aún no existe, anexa la cadena especificada al archivo y, a continuación, cierra el archivo.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Abre de forma asincrónica un archivo o crea el archivo si aún no existe, anexa la cadena especificada al archivo mediante la codificación especificada y, a continuación, cierra el archivo.
AppendText(String)	Crea un StreamWriter que anexa texto codificado UTF-8 a un archivo existente o a un archivo nuevo si el archivo especificado no existe.
Copy(String, String)	Copia un archivo existente en un archivo nuevo. No se permite sobrescribir un archivo con el mismo nombre.
Copy(String, String, Boolean)	Copia un archivo existente en un archivo nuevo. Se permite sobrescribir un archivo con el mismo nombre.
Create(String)	Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada.
Create(String, Int32)	Crea o trunca y sobrescribe un archivo en la ruta de acceso especificada, especificando un tamaño de búfer.
Create(String, Int32, FileOptions)	Crea o sobrescribe un archivo en la ruta de acceso especificada, especificando un tamaño y opciones de búfer que describen cómo crear o sobrescribir el archivo.
CreateSymbolicLink(String, String)	Crea un vínculo simbólico de archivo identificado por path que apunta a pathToTarget.
CreateText(String)	Crea o abre un archivo para escribir texto codificado UTF-8. Si el archivo ya existe, se reemplaza su contenido.
Decrypt(String)	Descifra un archivo cifrado por la cuenta actual mediante el método Encrypt(String).
Delete(String)	Elimina el archivo especificado.
Encrypt(String)	Cifra un archivo para que solo la cuenta utilizada para cifrar el archivo pueda descifrarlo.
Exists(String)	Determina si el archivo especificado existe.
GetAttributes(SafeFileHandle)	Obtiene el FileAttributes especificado del archivo o directorio asociado a fileHandle.
GetAttributes(String)	Obtiene el FileAttributes del archivo en la ruta de acceso.
GetCreationTime(SafeFileHandle)	Devuelve la hora de creación del archivo o directorio especificados.
GetCreationTime(String)	Devuelve la fecha y hora de creación del archivo o directorio especificados.
GetCreationTimeUtc(SafeFileHandle)	Devuelve la fecha y hora de creación, en Hora universal coordinada (UTC), del archivo o directorio especificados.
GetCreationTimeUtc(String)	Devuelve la fecha y hora de creación, en Hora universal coordinada (UTC), del archivo o directorio especificados.
GetLastAccessTime(SafeFileHandle)	Devuelve la última fecha y hora de acceso del archivo o directorio especificados.
GetLastAccessTime(String)	Devuelve la fecha y hora en que se accedió por última vez al archivo o directorio especificados.
GetLastAccessTimeUtc(SafeFileHandle)	Devuelve la última fecha y hora de acceso, en Hora universal coordinada (UTC), del archivo o directorio especificados.
GetLastAccessTimeUtc(String)	Devuelve la fecha y hora, en Hora universal coordinada (UTC), a la que se accedió por última vez al archivo o directorio especificados.
GetLastWriteTime(SafeFileHandle)	Devuelve la última fecha y hora de escritura del archivo o directorio especificados.
GetLastWriteTime(String)	Devuelve la fecha y hora en que se escribió por última vez el archivo o directorio especificados.
GetLastWriteTimeUtc(SafeFileHandle)	Devuelve la última fecha y hora de escritura, en Hora universal coordinada (UTC), del archivo o directorio especificados.
GetLastWriteTimeUtc(String)	Devuelve la fecha y hora, en Hora universal coordinada (UTC), en la que se escribió por última vez el archivo o directorio especificados.
GetUnixFileMode(SafeFileHandle)	Obtiene el UnixFileMode del identificador de archivo especificado.
GetUnixFileMode(String)	Obtiene el UnixFileMode del archivo en la ruta de acceso.
Move(String, String)	Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para especificar un nuevo nombre de archivo.
Move(String, String, Boolean)	Mueve un archivo especificado a una nueva ubicación, proporcionando las opciones para especificar un nuevo nombre de archivo y reemplazar el archivo de destino si ya existe.
Open(String, FileMode)	Abre un FileStream en la ruta de acceso especificada con acceso de lectura y escritura sin uso compartido.
Open(String, FileMode, FileAccess)	Abre un FileStream en la ruta de acceso especificada, con el modo especificado y el acceso sin uso compartido.
Open(String, FileMode, FileAccess, FileShare)	Abre un FileStream en la ruta de acceso especificada, teniendo el modo especificado con acceso de lectura, escritura o lectura y escritura y la opción de uso compartido especificada.
Open(String, FileStreamOptions)	Inicializa una nueva instancia de la clase FileStream con la ruta de acceso especificada, el modo de creación, el permiso de lectura y escritura y uso compartido, el acceso a otros FileStreams puede tener en el mismo archivo, el tamaño del búfer, las opciones de archivo adicionales y el tamaño de asignación.
OpenHandle(String, FileMode, FileAccess, FileShare, FileOptions, Int64)	Inicializa una nueva instancia de la clase SafeFileHandle con la ruta de acceso especificada, el modo de creación, el permiso de lectura y escritura y uso compartido, el acceso que otros safeFileHandles pueden tener en el mismo archivo, opciones de archivo adicionales y el tamaño de asignación.
OpenRead(String)	Abre un archivo existente para leer.
OpenText(String)	Abre un archivo de texto codificado UTF-8 existente para su lectura.
OpenWrite(String)	Abre un archivo existente o crea un nuevo archivo para escribirlo.
ReadAllBytes(String)	Abre un archivo binario, lee el contenido del archivo en una matriz de bytes y, a continuación, cierra el archivo.
ReadAllBytesAsync(String, CancellationToken)	Abre de forma asincrónica un archivo binario, lee el contenido del archivo en una matriz de bytes y, a continuación, cierra el archivo.
ReadAllLines(String)	Abre un archivo de texto, lee todas las líneas del archivo y, a continuación, cierra el archivo.
ReadAllLines(String, Encoding)	Abre un archivo, lee todas las líneas del archivo con la codificación especificada y, a continuación, cierra el archivo.
ReadAllLinesAsync(String, CancellationToken)	Abre de forma asincrónica un archivo de texto, lee todas las líneas del archivo y, a continuación, cierra el archivo.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Abre de forma asincrónica un archivo de texto, lee todas las líneas del archivo con la codificación especificada y, a continuación, cierra el archivo.
ReadAllText(String)	Abre un archivo de texto, lee todo el texto del archivo y, a continuación, cierra el archivo.
ReadAllText(String, Encoding)	Abre un archivo, lee todo el texto del archivo con la codificación especificada y, a continuación, cierra el archivo.
ReadAllTextAsync(String, CancellationToken)	Abre de forma asincrónica un archivo de texto, lee todo el texto del archivo y, a continuación, cierra el archivo.
ReadAllTextAsync(String, Encoding, CancellationToken)	Abre de forma asincrónica un archivo de texto, lee todo el texto del archivo con la codificación especificada y, a continuación, cierra el archivo.
ReadLines(String)	Lee las líneas de un archivo.
ReadLines(String, Encoding)	Lea las líneas de un archivo que tiene una codificación especificada.
ReadLinesAsync(String, CancellationToken)	Lee asincrónicamente las líneas de un archivo.
ReadLinesAsync(String, Encoding, CancellationToken)	Lee asincrónicamente las líneas de un archivo que tiene una codificación especificada.
Replace(String, String, String)	Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.
Replace(String, String, String, Boolean)	Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado y, opcionalmente, omite los errores de combinación.
ResolveLinkTarget(String, Boolean)	Obtiene el destino del vínculo de archivo especificado.
SetAttributes(SafeFileHandle, FileAttributes)	Establece el FileAttributes especificado del archivo o directorio asociado a fileHandle.
SetAttributes(String, FileAttributes)	Establece el FileAttributes especificado del archivo en la ruta de acceso especificada.
SetCreationTime(SafeFileHandle, DateTime)	Establece la fecha y hora en que se creó el archivo o directorio.
SetCreationTime(String, DateTime)	Establece la fecha y hora en que se creó el archivo.
SetCreationTimeUtc(SafeFileHandle, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), que se creó el archivo o directorio.
SetCreationTimeUtc(String, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), que se creó el archivo.
SetLastAccessTime(SafeFileHandle, DateTime)	Establece la fecha y hora en que se accedió por última vez al archivo o directorio especificados.
SetLastAccessTime(String, DateTime)	Establece la fecha y hora en que se accedió por última vez al archivo especificado.
SetLastAccessTimeUtc(SafeFileHandle, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), a la que se accedió por última vez al archivo o directorio especificados.
SetLastAccessTimeUtc(String, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), a la que se accedió por última vez al archivo especificado.
SetLastWriteTime(SafeFileHandle, DateTime)	Establece la fecha y hora en que se escribió por última vez el archivo o directorio especificados.
SetLastWriteTime(String, DateTime)	Establece la fecha y hora en que se escribió por última vez el archivo especificado.
SetLastWriteTimeUtc(SafeFileHandle, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), en la que se escribió por última vez el archivo o directorio especificados.
SetLastWriteTimeUtc(String, DateTime)	Establece la fecha y hora, en Hora universal coordinada (UTC), en la que se escribió por última vez el archivo especificado.
SetUnixFileMode(SafeFileHandle, UnixFileMode)	Establece el UnixFileMode especificado del identificador de archivo especificado.
SetUnixFileMode(String, UnixFileMode)	Establece el UnixFileMode especificado del archivo en la ruta de acceso especificada.
WriteAllBytes(String, Byte[])	Crea un nuevo archivo, escribe la matriz de bytes especificada en el archivo y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.
WriteAllBytesAsync(String, Byte[], CancellationToken)	Crea de forma asincrónica un nuevo archivo, escribe la matriz de bytes especificada en el archivo y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.
WriteAllLines(String, IEnumerable<String>)	Crea un nuevo archivo, escribe una colección de cadenas en el archivo y, a continuación, cierra el archivo.
WriteAllLines(String, IEnumerable<String>, Encoding)	Crea un nuevo archivo mediante la codificación especificada, escribe una colección de cadenas en el archivo y, a continuación, cierra el archivo.
WriteAllLines(String, String[])	Crea un nuevo archivo, escribe la matriz de cadenas especificada en el archivo y, a continuación, cierra el archivo.
WriteAllLines(String, String[], Encoding)	Crea un nuevo archivo, escribe la matriz de cadenas especificada en el archivo mediante la codificación especificada y, a continuación, cierra el archivo.
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Crea de forma asincrónica un nuevo archivo, escribe las líneas especificadas en el archivo y, a continuación, cierra el archivo.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Crea de forma asincrónica un nuevo archivo, escribe las líneas especificadas en el archivo mediante la codificación especificada y, a continuación, cierra el archivo.
WriteAllText(String, String)	Crea un nuevo archivo, escribe la cadena especificada en el archivo y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.
WriteAllText(String, String, Encoding)	Crea un nuevo archivo, escribe la cadena especificada en el archivo mediante la codificación especificada y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.
WriteAllTextAsync(String, String, CancellationToken)	Crea de forma asincrónica un nuevo archivo, escribe la cadena especificada en el archivo y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Crea de forma asincrónica un nuevo archivo, escribe la cadena especificada en el archivo mediante la codificación especificada y, a continuación, cierra el archivo. Si el archivo de destino ya existe, se trunca y se sobrescribe.

Consulte también

• DriveInfo
• FileSystemWatcher
• de E/S de flujo y archivos
• leer texto de un archivo
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado