Compartilhar 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 oferecidas estão: se o arquivo excluído deve ser enviado para a Lixeira, se o usuário deve confirmar se 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 que confirme se 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 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)
    

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 do 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á sendo usado (IOException).

  • O usuário não tem 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).

  • Existe 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).

Consulte também