File.Exists(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de