File.Exists(String) Método

public:
 static bool Exists(System::String ^ path);

public static bool Exists(string path);

static member Exists : string -> bool

Public Shared Function Exists (path As String) As Boolean

Parâmetros

Devoluções

true se o chamador tiver as permissões necessárias e path contiver o nome de um ficheiro existente; caso contrário, false. Este método também retorna 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 ficheiro especificado, não é lançada nenhuma exceção e o método retorna false independentemente da existência de path.

Exemplos

O exemplo seguinte determina se existe um ficheiro.

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."))

Observações

Não use o Exists método para validação de caminhos; este método apenas verifica se o ficheiro especificado em path existe. Passar um caminho inválido para Exists retorna false. Para verificar se o caminho contém caracteres inválidos, pode chamar o GetInvalidPathChars método para recuperar os caracteres inválidos para o sistema de ficheiros. Também pode criar uma expressão regular para testar se o caminho é válido para o seu ambiente. Para exemplos de caminhos aceitáveis, veja File.

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

Tenha em atenção que outro processo pode potencialmente fazer algo com o ficheiro entre o momento em que chama o Exists método e realiza outra operação no ficheiro, como Delete.

O path parâmetro pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual. Para obter o diretório de trabalho atual, veja GetCurrentDirectory.

Se path descreve um diretório, este método devolve false. Os espaços finais são removidos do path parâmetro antes de determinar se o ficheiro existe.

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

Ver também

• Exists(String)
• E/S de arquivo e fluxo
• Leitura de Texto de Um Ficheiro
• Como: Gravar texto em um arquivo