FileSystem.DeleteFile Método

Referência

Definição

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: FileSystem.vb

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

Aplica-se a

DeleteFile(String, UIOption, RecycleOption)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

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

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

Aplica-se a

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Origem:: FileSystem.vb

Origem:: FileSystem.vb

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

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

Aplica-se a

Compartilhar via

FileSystem.DeleteFile Método

Definição

Sobrecargas

DeleteFile(String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

DeleteFile(String, UIOption, RecycleOption)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais