FileSystem.DeleteFile Método

Definição

Namespace:: Microsoft.VisualBasic.FileIO

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

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

DeleteFile(String)

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

Nome e 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 comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ele tem uma barra à direita em que um arquivo deve ser especificado; ou é um caminho do dispositivo (começa com \\.\).

ArgumentNullException

file é ou uma Nothing cadeia de caracteres vazia.

PathTooLongException

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

NotSupportedException

Um nome de arquivo ou 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 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 que envolve o My.Computer.FileSystem.DeleteFile método.

Para	Veja
Para excluir um arquivo	Como excluir um arquivo em Visual Basic

Aplica-se a

DeleteFile(String, UIOption, RecycleOption)

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

Nome e caminho do arquivo a ser excluído.

showUI: UIOption

Se deseja acompanhar visualmente o progresso da operação. 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 é ou uma Nothing cadeia de caracteres vazia.

PathTooLongException

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

NotSupportedException

Um nome de arquivo ou 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 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 parâmetros showUI e recycle não têm suporte em aplicativos que não são interativos pelo usuário, como Windows Services.

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

Para	Veja
Para excluir um arquivo	Como excluir um arquivo em Visual Basic

Confira também

Aplica-se a

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

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

Nome e caminho do arquivo a ser excluído.

showUI: UIOption

Se deseja acompanhar visualmente o progresso da operação. 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 é gerada ou não quando o usuário cancela a operação. O padrão é UICancelOption.ThrowException.

Exceções

ArgumentException

ArgumentNullException

file é ou uma Nothing cadeia de caracteres vazia.

PathTooLongException

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

NotSupportedException

Um nome de arquivo ou 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 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 como 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 parâmetros showUI, recycle e onUserCancel não têm suporte em aplicativos que não são interativos pelo usuário, como Windows Services.

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

Para	Veja
Para excluir um arquivo	Como excluir um arquivo em Visual Basic

Confira também

Aplica-se a

Comentários

Esta página foi útil?