FileInfo Clase

Definición

Proporciona propiedades y métodos de instancia para la creación, copia, eliminación, movimiento y apertura de archivos, y ayuda a la creación de objetos FileStream. Esta clase no se puede heredar.

public ref class FileInfo sealed : System::IO::FileSystemInfo
public sealed class FileInfo : System.IO.FileSystemInfo
[System.Serializable]
public sealed class FileInfo : System.IO.FileSystemInfo
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FileInfo : System.IO.FileSystemInfo
type FileInfo = class
    inherit FileSystemInfo
[<System.Serializable>]
type FileInfo = class
    inherit FileSystemInfo
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileInfo = class
    inherit FileSystemInfo
Public NotInheritable Class FileInfo
Inherits FileSystemInfo
Herencia
Herencia
Atributos

Ejemplos

En el ejemplo siguiente se muestran algunos de los miembros principales de la clase FileInfo.

Cuando se recuperan por primera vez las propiedades, FileInfo llama al método Refresh y almacena en caché información sobre el archivo. En las llamadas posteriores, debe llamar a Refresh para obtener la copia más reciente de la información.

using namespace System;
using namespace System::IO;

int main()
{
   String^ path = Path::GetTempFileName();
   FileInfo^ fi1 = gcnew FileInfo( path );
   //Create a file to write to.
   StreamWriter^ sw = fi1->CreateText();
   try
   {
     sw->WriteLine( "Hello" );
     sw->WriteLine( "And" );
     sw->WriteLine( "Welcome" );
   }
   finally
   {
     if ( sw )
        delete (IDisposable^)sw;
   }

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

   try
   {
      String^ path2 = Path::GetTempFileName();
      FileInfo^ fi2 = gcnew FileInfo( path2 );

      //Ensure that the target does not exist.
      fi2->Delete();

      //Copy the file.
      fi1->CopyTo( path2 );
      Console::WriteLine( "{0} was copied to {1}.", path, path2 );

      //Delete the newly created file.
      fi2->Delete();
      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 = Path.GetTempFileName();
        var fi1 = new FileInfo(path);

        // Create a file to write to.
        using (StreamWriter sw = fi1.CreateText())
        {
            sw.WriteLine("Hello");
            sw.WriteLine("And");
            sw.WriteLine("Welcome");
        }	

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

        try
        {
            string path2 = Path.GetTempFileName();
            var fi2 = new FileInfo(path2);

            // Ensure that the target does not exist.
            fi2.Delete();

            // Copy the file.
            fi1.CopyTo(path2);
            Console.WriteLine($"{path} was copied to {path2}.");

            // Delete the newly created file.
            fi2.Delete();
            Console.WriteLine($"{path2} was successfully deleted.");
        }
        catch (Exception e)
        {
            Console.WriteLine($"The process failed: {e.ToString()}");
        }
    }
}
Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = Path.GetTempFileName()
        Dim path2 As String = Path.GetTempFileName()
        Dim fi As New FileInfo(path1)

        ' Create a file to write to.
        Using sw As StreamWriter = fi.CreateText()
            sw.WriteLine("Hello")
            sw.WriteLine("And")
            sw.WriteLine("Welcome")
        End Using

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

            Dim fi2 As New FileInfo(path2)

            ' Ensure that the target does not exist.
            fi2.Delete()

            ' Copy the file.
            fi.CopyTo(path2)
            Console.WriteLine($"{path1} was copied to {path2}.")

            ' Delete the newly created file.
            fi2.Delete()
            Console.WriteLine($"{path2} was successfully deleted.")

        Catch e As Exception
            Console.WriteLine($"The process failed: {e.ToString()}.")
        End Try
    End Sub
End Class

En este ejemplo se genera una salida similar a la siguiente.

Hello
And
Welcome
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.

Comentarios

Use la clase FileInfo para operaciones típicas como copiar, mover, cambiar el nombre, crear, abrir, eliminar y anexar a archivos.

Si realiza varias operaciones en el mismo archivo, puede ser más eficaz usar FileInfo métodos de instancia en lugar de los métodos estáticos correspondientes de la clase File, ya que no siempre será necesaria una comprobación de seguridad.

Muchos de los métodos FileInfo 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 FileInfo específicos, como Open, OpenRead, OpenText, CreateTexto Create.

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 FileInfo.

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.

La clase FileInfo proporciona las siguientes propiedades que permiten recuperar información sobre un archivo. Para obtener un ejemplo de cómo usar cada propiedad, vea las páginas de propiedades.

  • La propiedad Directory recupera un objeto que representa el directorio primario de un archivo.

  • La propiedad DirectoryName recupera la ruta de acceso completa del directorio primario de un archivo.

  • La propiedad Exists comprueba la presencia de un archivo antes de operar en él.

  • La propiedad IsReadOnly recupera o establece un valor que especifica si se puede modificar un archivo.

  • El Length recupera el tamaño de un archivo.

  • El Name recupera el nombre de un archivo.

Constructores

FileInfo(String)

Inicializa una nueva instancia de la clase FileInfo, que actúa como contenedor para una ruta de acceso de archivo.

Campos

FullPath

Representa la ruta de acceso completa del directorio o archivo.

(Heredado de FileSystemInfo)
OriginalPath

Ruta de acceso especificada originalmente por el usuario, ya sea relativa o absoluta.

(Heredado de FileSystemInfo)

Propiedades

Attributes

Obtiene o establece los atributos del archivo o directorio actual.

(Heredado de FileSystemInfo)
CreationTime

Obtiene o establece la hora de creación del archivo o directorio actual.

(Heredado de FileSystemInfo)
CreationTimeUtc

Obtiene o establece la hora de creación, en hora universal coordinada (UTC), del archivo o directorio actual.

(Heredado de FileSystemInfo)
Directory

Obtiene una instancia del directorio primario.

DirectoryName

Obtiene una cadena que representa la ruta de acceso completa del directorio.

Exists

Obtiene un valor que indica si existe un archivo.

Extension

Obtiene la parte de extensión del nombre de archivo, incluido el punto inicial . incluso si es el nombre de archivo completo o una cadena vacía si no hay ninguna extensión presente.

(Heredado de FileSystemInfo)
FullName

Obtiene la ruta de acceso completa del directorio o archivo.

(Heredado de FileSystemInfo)
IsReadOnly

Obtiene o establece un valor que determina si el archivo actual es de solo lectura.

LastAccessTime

Obtiene o establece la hora en que se accedió por última vez al archivo o directorio actual.

(Heredado de FileSystemInfo)
LastAccessTimeUtc

Obtiene o establece la hora, en hora universal coordinada (UTC), a la que se accedió por última vez al archivo o directorio actual.

(Heredado de FileSystemInfo)
LastWriteTime

Obtiene o establece la hora en la que se escribió por última vez el archivo o directorio actual.

(Heredado de FileSystemInfo)
LastWriteTimeUtc

Obtiene o establece la hora, en hora universal coordinada (UTC), en la que se escribió por última vez el archivo o directorio actual.

(Heredado de FileSystemInfo)
Length

Obtiene el tamaño, en bytes, del archivo actual.

LinkTarget

Obtiene la ruta de acceso de destino del vínculo ubicado en FullName, o null si esta instancia de FileSystemInfo no representa un vínculo.

(Heredado de FileSystemInfo)
Name

Obtiene el nombre del archivo.

UnixFileMode

Obtiene o establece el modo de archivo unix para el archivo o directorio actual.

(Heredado de FileSystemInfo)

Métodos

AppendText()

Crea un StreamWriter que anexa texto al archivo representado por esta instancia del FileInfo.

CopyTo(String)

Copia un archivo existente en un archivo nuevo, lo que impide la sobrescritura de un archivo existente.

CopyTo(String, Boolean)

Copia un archivo existente en un nuevo archivo, lo que permite sobrescribir un archivo existente.

Create()

Crea un archivo.

CreateAsSymbolicLink(String)

Crea un vínculo simbólico ubicado en FullName que apunta al pathToTargetespecificado.

(Heredado de FileSystemInfo)
CreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
CreateText()

Crea un StreamWriter que escribe un nuevo archivo de texto.

Decrypt()

Descifra un archivo cifrado por la cuenta actual mediante el método Encrypt().

Delete()

Elimina permanentemente un archivo.

Encrypt()

Cifra un archivo para que solo la cuenta utilizada para cifrar el archivo pueda descifrarlo.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetAccessControl()

Obtiene un objeto FileSecurity que encapsula las entradas de la lista de control de acceso (ACL) para el archivo descrito por el objeto FileInfo actual.

GetAccessControl(AccessControlSections)

Obtiene un objeto FileSecurity que encapsula el tipo especificado de entradas de lista de control de acceso (ACL) para el archivo descrito por el objeto FileInfo actual.

GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)
Obsoletos.

Establece el objeto SerializationInfo con el nombre de archivo y la información de excepción adicional.

(Heredado de FileSystemInfo)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
MoveTo(String)

Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para especificar un nuevo nombre de archivo.

MoveTo(String, Boolean)

Mueve un archivo especificado a una nueva ubicación, proporcionando las opciones para especificar un nuevo nombre de archivo y sobrescribir el archivo de destino si ya existe.

Open(FileMode)

Abre un archivo en el modo especificado.

Open(FileMode, FileAccess)

Abre un archivo en el modo especificado con acceso de lectura, escritura o lectura y escritura.

Open(FileMode, FileAccess, FileShare)

Abre un archivo en el modo especificado con acceso de lectura, escritura o lectura y escritura y la opción de uso compartido especificada.

Open(FileStreamOptions)

Inicializa una nueva instancia de la clase FileStream con el modo de creación, el permiso de lectura y escritura y uso compartido especificados, 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.

OpenRead()

Crea un FileStreamde solo lectura.

OpenText()

Crea un StreamReader con codificación UTF8 que lee de un archivo de texto existente.

OpenWrite()

Crea un FileStreamde solo escritura.

Refresh()

Actualiza el estado del objeto.

(Heredado de FileSystemInfo)
Replace(String, String)

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.

Replace(String, String, Boolean)

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado. Especifica también si se omitirán los errores de combinación.

ResolveLinkTarget(Boolean)

Obtiene el destino del vínculo especificado.

(Heredado de FileSystemInfo)
SetAccessControl(FileSecurity)

Aplica entradas de lista de control de acceso (ACL) descritas por un objeto FileSecurity al archivo descrito por el objeto FileInfo actual.

ToString()

Devuelve la ruta de acceso original que se pasó al constructor FileInfo. Use la propiedad FullName o Name para la ruta de acceso completa o el nombre de archivo.

ToString()

Devuelve la ruta de acceso original. Use las propiedades FullName o Name para la ruta de acceso completa o el nombre de archivo o directorio.

(Heredado de FileSystemInfo)

Métodos de extensión

Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Crea una nueva secuencia de archivos, asegurándose de que se crea con las propiedades y la configuración de seguridad especificadas.

GetAccessControl(FileInfo)

Devuelve la información de seguridad de un archivo.

GetAccessControl(FileInfo, AccessControlSections)

Devuelve la información de seguridad de un archivo.

SetAccessControl(FileInfo, FileSecurity)

Cambia los atributos de seguridad de un archivo existente.

Se aplica a

Consulte también