Compartilhar via


Como excluir um arquivo no Visual Basic

O método DeleteFile do objeto My.Computer.FileSystem permite a exclusão de um arquivo. As opções oferecidas são: enviar um arquivo excluído para a Lixeira, solicitar do usuário uma confirmação de que o arquivo deve ser excluído e o que fazer quando o usuário cancela a operação.

Excluir um arquivo de texto

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

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

Excluir um arquivo de texto e solicitar do usuário uma confirmação de que o arquivo deve ser excluído

  • Use o método DeleteFile para excluir o arquivo, configurando showUI para AllDialogs. O código a seguir demonstra como excluir o arquivo com o nome test.txt e permitir que o usuário confirme se 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)
    

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

  • Use o método DeleteFile para excluir o arquivo, especificando SendToRecycleBin para o parâmetro recycle. O código a seguir demonstra como excluir o arquivo com o nome 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 comprimento zero, contém apenas espaços 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 pasta no caminho contém dois pontos (:) ou está em um formato inválido (NotSupportedException).

  • O arquivo está sendo usado (IOException).

  • O usuário não possui permissões necessárias para exibir o caminho (SecurityException).

  • O arquivo não existe (FileNotFoundException).

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

  • Há uma situação de confiança parcial na qual o usuário não tem permissões suficientes (SecurityException).

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

Confira também