Método My.Computer.FileSystem.FindInFiles

Artigo
08/25/2010

Exclui um arquivo.

' Usage
My.Computer.FileSystem.DeleteFile(file)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteFile( _
   ByVal file As String _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

file
String.Nome e caminho do arquivo a ser excluído.Obrigatório.
showUI
UIOption.Se rastreiem visualmente o progresso da operação.O padrão é UIOption.OnlyErrorDialogs.Obrigatório.
recycle
RecycleOption.Se o arquivo excluído deve ser enviado para o Da Lixeira.O padrão é RecycleOption.DeletePermanently.Obrigatório.
onUserCancel
UICancelOption.Especifica se uma exceção é lançada quando o usuário cancela a operação.O padrão é UICancelOption.ThrowException.Obrigatório.

Exceções

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

O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; contém somente espaços em branco; ele contém caracteres inválidos; ele tem uma barra / à direita de onde deve ser especificado um arquivo; 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 nome de arquivo ou de diretório 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 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 UICancelOption.ThrowException (OperationCanceledException).

Comentários

Os parâmetros showUI,recycle, e onUserCancel não são suportados em aplicativos que não forem interativos com o usuário, como serviços do Windows.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.DeleteFile.

Para	Consulte
Para excluir um arquivo	Como: Excluir um arquivo no Visual Basic
Para excluir todos os arquivos em uma pasta	Como: Excluir Tudo arquivos em um diretório no Visual Basic

Exemplo

Este exemplo exclui o arquivo Test.txt.

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

Este exemplo exclui o arquivo Test.txt e permite que o usuário confirme se o arquivo deve ser excluído.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

Este exemplo exclui o arquivo Test.txt e a envia para a Lixeira.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.OnlyErrorDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: SafeSubWindows.