FileInfo Classe

Definição

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

Herança

Object

FileSystemInfo

FileInfo

Herança

Object

MarshalByRefObject

FileSystemInfo

FileInfo

Atributos

SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo a seguir demonstra alguns dos principais membros da FileInfo classe.

Quando as propriedades são recuperadas pela primeira vez, FileInfo chama o Refresh método e armazena em cache informações sobre o arquivo. Nas chamadas subsequentes, você deve ligar Refresh para obter a cópia mais recente das informações.

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

Este exemplo produz uma saída semelhante à seguinte.

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.

Comentários

Use a FileInfo classe para operações típicas, como copiar, mover, renomear, criar, abrir, excluir e acrescentar arquivos.

Se você estiver executando várias operações no mesmo arquivo, poderá ser mais eficiente usar FileInfo métodos de instância em vez dos métodos estáticos correspondentes da File classe, pois uma verificação de segurança nem sempre será necessária.

Muitos dos FileInfo métodos retornam outros tipos de E/S quando você cria ou abre arquivos. Você pode usar esses outros tipos para manipular ainda mais um arquivo. Para obter mais informações, consulte membros específicosFileInfo, como Open, OpenRead, OpenText, ou CreateTextCreate.

Por padrão, o acesso completo de leitura/gravação a novos arquivos é concedido a todos os usuários.

A tabela a seguir descreve as enumerações usadas para personalizar o comportamento de vários FileInfo métodos.

Em membros que aceitam um caminho, o caminho pode se referir a um arquivo ou apenas a um diretório. O caminho especificado também pode se referir a um caminho relativo ou a um caminho UNC (Convenção Universal de Nomenclatura) para um servidor e um nome de compartilhamento. Por exemplo, todos os seguintes são caminhos aceitáveis:

• "c:\\MyDir\\MyFile.txt" em C#ou "c:\MyDir\MyFile.txt" no Visual Basic.

• "c:\\MyDir" em C#ou "c:\MyDir" no Visual Basic.

• "MyDir\\MySubdir" em C#ou "MyDir\MySubDir" no Visual Basic.

• "\\\\MyServer\\MyShare" em C#ou "\\MyServer\MyShare" no Visual Basic.

A FileInfo classe fornece as propriedades a seguir que permitem recuperar informações sobre um arquivo. Para obter um exemplo de como usar cada propriedade, consulte as páginas de propriedades.

• A Directory propriedade recupera um objeto que representa o diretório pai de um arquivo.

• A DirectoryName propriedade recupera o caminho completo do diretório pai de um arquivo.

• A Exists propriedade verifica a presença de um arquivo antes de operar nele.

• A IsReadOnly propriedade recupera ou define um valor que especifica se um arquivo pode ser modificado.

• Recupera Length o tamanho de um arquivo.

• Recupera Name o nome de um arquivo.

Confira também

• FileSystemWatcher
• DriveInfo
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo
• Como ler e gravar em um arquivo de dados recém-criado