Método My.Computer.FileSystem.FindInFiles

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.

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

Permissões

As seguintes permissões podem ser necessárias:

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Excluir um diretório no Visual Basic

Referência

Objeto My.Computer.FileSystem

Enumeração UIOption

Enumeração RecycleOption

Enumeração UICancelOption

FileSystem.DeleteFile

Objeto My.Computer.FileSystem