File.Exists(String) Método

Definição

Determina se o arquivo especificado existe.

public:
 static bool Exists(System::String ^ path);
public static bool Exists (string path);
public static bool Exists (string? path);
static member Exists : string -> bool
Public Shared Function Exists (path As String) As Boolean

Parâmetros

path
String

O arquivo a ser verificado.

Retornos

true se o chamador tiver as permissões necessárias e path contiver o nome de um arquivo existente; caso contrário, false. Esse método também retornará false se path for null, um caminho inválido ou uma cadeia de comprimento zero. Se o chamador não tiver permissões suficientes para ler o arquivo especificado, nenhuma exceção será lançada e o método retornará false independentemente da existência de path.

Exemplos

O exemplo a seguir determina se existe um arquivo.

string curFile = @"c:\temp\test.txt";
Console.WriteLine(File.Exists(curFile) ? "File exists." : "File does not exist.");
let curFile = @"c:\temp\test.txt"

printfn
    $"""{if File.Exists curFile then
             "File exists."
         else
             "File does not exist."}"""
Dim curFile As String = "c:\temp\test.txt"
Console.WriteLine(If(File.Exists(curFile), "File exists.", "File does not exist."))

Comentários

O Exists método não deve ser usado para validação de caminho, esse método apenas verifica se o arquivo especificado em path existe. Passar um caminho inválido para Exists retorna false. Para verificar se o caminho contém caracteres inválidos, você pode chamar o GetInvalidPathChars método para recuperar os caracteres inválidos para o sistema de arquivos. Você também pode criar uma expressão regular para testar se o caminho é válido para seu ambiente. Para obter exemplos de caminhos aceitáveis, consulte File.

Para verificar se existe um diretório, consulte Directory.Exists.

Lembre-se de que outro processo pode potencialmente fazer algo com o arquivo entre o tempo em que você chama o Exists método e executar outra operação no arquivo, como Delete.

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

Se path descrever um diretório, esse método retornará false. Espaços à direita são removidos do path parâmetro antes de determinar se o arquivo existe.

O Exists método retornará false se ocorrer algum erro ao tentar determinar se o arquivo especificado existe. Isso pode ocorrer em situações que geram exceções, como passar um nome de arquivo com caracteres inválidos ou muitos caracteres, um disco com falha ou ausente ou se o chamador não tiver permissão para ler o arquivo.

Aplica-se a

Confira também