Compartilhar via


FileSystem.DeleteFile Método

Definição

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

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 \\.\).

file é Nothing ou é uma cadeia de caracteres vazia.

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

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

O arquivo está em uso.

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

O arquivo não existe.

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

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 \\.\).

file é Nothing ou é uma cadeia de caracteres vazia.

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

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

O arquivo está em uso.

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

O arquivo não existe.

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

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 \\.\).

file é Nothing ou é uma cadeia de caracteres vazia.

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

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

O arquivo está em uso.

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

O arquivo não existe.

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

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