FileSystem.DeleteFile Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Exclui um arquivo.

Sobrecargas

DeleteFile(String)	Exclui um arquivo.
DeleteFile(String, UIOption, RecycleOption)	Exclui um arquivo.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Exclui um arquivo.

DeleteFile(String)

Origem:

FileSystem.vb

Exclui um arquivo.

public:
 static void DeleteFile(System::String ^ file);

public static void DeleteFile (string file);

static member DeleteFile : string -> unit

Public Shared Sub DeleteFile (file As String)

Parâmetros

file

String

O nome e o caminho do arquivo a ser excluído.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de tamanho zero; contém somente espaço em branco; contém caracteres inválidos; tem uma barra invertida na qual um arquivo deve ser especificado; ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

file é Nothing ou é uma cadeia de caracteres vazia.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

IOException

O arquivo está em uso.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

FileNotFoundException

O arquivo não existe.

UnauthorizedAccessException

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

Exemplos

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 o envia para a Lixeira.

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

Comentários

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.DeleteFile método .

Para	Consulte
Para excluir um arquivo	Como excluir um arquivo no Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Origem:

FileSystem.vb

Exclui um arquivo.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

Parâmetros

file

String

O nome e o caminho do arquivo a ser excluído.

showUI

UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Se o arquivo excluído deve ou não ser enviado para a Lixeira. O padrão é RecycleOption.DeletePermanently.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de tamanho zero; contém somente espaço em branco; contém caracteres inválidos; tem uma barra invertida na qual um arquivo deve ser especificado; ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

file é Nothing ou é uma cadeia de caracteres vazia.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

IOException

O arquivo está em uso.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

FileNotFoundException

O arquivo não existe.

UnauthorizedAccessException

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

Exemplos

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 o envia para a Lixeira.

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

Comentários

Os showUI parâmetros e recycle não têm suporte em aplicativos que não são interativos pelo usuário, como os Serviços do Windows.

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.DeleteFile método .

Para	Consulte
Para excluir um arquivo	Como excluir um arquivo no Visual Basic

Confira também

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Origem:

FileSystem.vb

Exclui um arquivo.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parâmetros

file

String

O nome e o caminho do arquivo a ser excluído.

showUI

UIOption

Se o progresso da operação deve ser acompanhado visualmente. O padrão é UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Se o arquivo excluído deve ou não ser enviado para a Lixeira. O padrão é RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Especifica se uma exceção é lançada ou não quando o usuário cancela a operação. O padrão é UICancelOption.ThrowException.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de tamanho zero; contém somente espaço em branco; contém caracteres inválidos; tem uma barra invertida na qual um arquivo deve ser especificado; ou é um caminho de dispositivo (começa com \\.\).

ArgumentNullException

file é Nothing ou é uma cadeia de caracteres vazia.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

IOException

O arquivo está em uso.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

FileNotFoundException

O arquivo não existe.

UnauthorizedAccessException

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

OperationCanceledException

O usuário cancelou a operação e onUserCancel está definido para ThrowException.

Exemplos

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 o envia para a Lixeira.

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

Comentários

Os showUIparâmetros , recyclee onUserCancel não têm suporte em aplicativos que não são interativos pelo usuário, como os Serviços do Windows.

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.DeleteFile método .

Para	Consulte
Para excluir um arquivo	Como excluir um arquivo no Visual Basic

Confira também

• UICancelOption
• RecycleOption
• UIOption