Partilhar via


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 caracteres de comprimento zero. Se o chamador não tiver permissões suficientes para ler o arquivo especificado, nenhuma exceção será gerada 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

Não use o método Exists para validação de caminho; este método apenas verifica se o arquivo especificado no 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 método GetInvalidPathChars 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 método Exists e executar outra operação no arquivo, como Delete.

O parâmetro path tem permissão para especificar informações de caminho relativas ou absolutas. As informações de 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 parâmetro path antes de determinar se o arquivo existe.

O método Exists retorna 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 ausente ou com falha ou se o chamador não tiver permissão para ler o arquivo.

Aplica-se a

Confira também