File.Exists(String) Método

Definição

Determina se o arquivo especificado existe.Determines whether the specified file exists.

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.The file to check.

Retornos

Boolean

true se o chamador tiver as permissões necessárias e path contiver o nome de um arquivo existente; caso contrário, false.true if the caller has the required permissions and path contains the name of an existing file; otherwise, false. Esse método também retornará false se path for null, um caminho inválido ou uma cadeia de comprimento zero.This method also returns false if path is null, an invalid path, or a zero-length string. 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.If the caller does not have sufficient permissions to read the specified file, no exception is thrown and the method returns false regardless of the existence of path.

Exemplos

O exemplo a seguir determina se um arquivo existe.The following example determines if a file exists.

string curFile = @"c:\temp\test.txt";
Console.WriteLine(File.Exists(curFile) ? "File exists." : "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 a validação de caminho, esse método simplesmente verifica se o arquivo especificado path existe.The Exists method should not be used for path validation, this method merely checks if the file specified in path exists. Passando um caminho inválido para Exists retornos false .Passing an invalid path to Exists returns false. Para verificar se o caminho contém caracteres inválidos, você pode chamar o GetInvalidPathChars método para recuperar os caracteres que são inválidos para o sistema de arquivos.To check whether the path contains any invalid characters, you can call the GetInvalidPathChars method to retrieve the characters that are invalid for the file system. Você também pode criar uma expressão regular para testar se o caminho é válido para o seu ambiente.You can also create a regular expression to test the whether the path is valid for your environment. Para obter exemplos de caminhos aceitáveis, consulte File .For examples of acceptable paths, see File.

Para verificar se existe um diretório, consulte Directory.Exists .To check if a directory exists, see Directory.Exists.

Lembre-se de que outro processo pode potencialmente fazer algo com o arquivo entre o tempo que você chama o Exists método e executar outra operação no arquivo, como Delete .Be aware that another process can potentially do something with the file in between the time you call the Exists method and perform another operation on the file, such as Delete.

O path parâmetro tem permissão para especificar informações de caminho relativo ou absoluto.The path parameter is permitted to specify relative or absolute path information. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual.Relative path information is interpreted as relative to the current working directory. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory .To obtain the current working directory, see GetCurrentDirectory.

Se path o descrever um diretório, esse método retornará false .If path describes a directory, this method returns false. Os espaços à direita são removidos do path parâmetro antes de determinar se o arquivo existe.Trailing spaces are removed from the path parameter before determining if the file exists.

O Exists método retornará false se ocorrer algum erro durante a tentativa de determinar se o arquivo especificado existe.The Exists method returns false if any error occurs while trying to determine if the specified file exists. 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.This can occur in situations that raise exceptions such as passing a file name with invalid characters or too many characters, a failing or missing disk, or if the caller does not have permission to read the file.

Aplica-se a

Confira também