Partilhar via


Como: excluir um arquivo em Visual Basic

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

Para excluir um arquivo de texto

  • Use o método DeleteFile 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 perguntar aos usuários para confirmar se o arquivo deve ser excluído

  • Use o método DeleteFile para excluir o arquivo, definindo showUI como AllDialogs.O código a seguir demonstra como excluir o arquivo chamado test.txt e permite ao usuário confirmar 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 Recycle Bin

  • 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 chamado test.txt e enviá-lo para a Recycle Bin.

    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 para uma das seguintes razões: ele é uma seqüência de comprimento zero, ele contém somente espaços em branco, ele contém caracteres inválidos ou é um caminho de dispositivo (começa com \ \.\) (ArgumentException).

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

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

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

  • O arquivo está em uso (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 para leitura (UnauthorizedAccessException).

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

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

Consulte também

Tarefas

Como: obter a coleção de arquivos em um diretório em Visual Basic

Referência

UICancelOption

FileSystem

UIOption

RecycleOption