FileInfo Clase

Definición

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

Object

FileSystemInfo

FileInfo

Herencia

Object

MarshalByRefObject

FileSystemInfo

FileInfo

Atributos

SerializableAttribute ComVisibleAttribute

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.

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

Campos

Propiedades

Métodos

Métodos de extensión

Se aplica a

Consulte también

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