Partilhar via


Como: Excluir um arquivo no Visual Basic

O DeleteFile método do My.Computer.FileSystem objeto permite que você exclua um arquivo. Entre as opções que ele oferece estão: se enviar o arquivo excluído para a Lixeira, se pedir ao usuário para confirmar que o arquivo deve ser excluído e o que fazer quando o usuário cancela a operação.

Para excluir um arquivo de texto

  • Use o DeleteFile método para excluir o arquivo. O código a seguir demonstra como excluir o arquivo chamado test.txt.

    My.Computer.FileSystem.DeleteFile("C:\test.txt")
    

Para excluir um arquivo de texto e pedir ao usuário para confirmar que o arquivo deve ser excluído

  • Use o DeleteFile método para excluir o arquivo, definindo showUI como AllDialogs. O código a seguir demonstra como excluir o arquivo nomeado test.txt e permitir que o usuário confirme que o arquivo deve ser excluído.

    My.Computer.FileSystem.DeleteFile("C:\test.txt",
            Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
            Microsoft.VisualBasic.FileIO.RecycleOption.DeletePermanently,
            Microsoft.VisualBasic.FileIO.UICancelOption.DoNothing)
    

Para excluir um arquivo de texto e enviá-lo para a Lixeira

  • Use o DeleteFile método para excluir o arquivo, especificando SendToRecycleBin para o recycle parâmetro. O código a seguir demonstra como excluir o arquivo nomeado test.txt e enviá-lo para a Lixeira.

    My.Computer.FileSystem.DeleteFile("C:\test.txt",
    Microsoft.VisualBasic.FileIO.UIOption.AllDialogs,
    Microsoft.VisualBasic.FileIO.RecycleOption.SendToRecycleBin)
    

Programação robusta

As seguintes condições podem causar uma exceção:

  • O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).

  • O caminho não é válido porque é Nothing (ArgumentNullException).

  • O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).

  • Um nome de arquivo ou pasta no caminho contém dois pontos (:) ou está em um formato inválido (NotSupportedException).

  • O arquivo está em uso (IOException).

  • O usuário não tem as permissões necessárias para visualizar o caminho (SecurityException).

  • O ficheiro não existe (FileNotFoundException).

  • O usuário não tem permissão para excluir o arquivo ou o arquivo é somente leitura (UnauthorizedAccessException).

  • Existe uma situação de confiança parcial em que o usuário não tem permissões suficientes (SecurityException).

  • O usuário cancelou a operação e onUserCancel está definido como ThrowException (OperationCanceledException).

Consulte também