FileSystemProxy.DeleteFile Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.MyServices

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Exclui um arquivo.

Sobrecargas

Name	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:
 void DeleteFile(System::String ^ file);

public void DeleteFile(string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

Parâmetros

file: String

Nome e caminho do ficheiro a eliminar.

Exceções

ArgumentException

O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; tem uma barra final onde um ficheiro deve ser especificado; Ou é um caminho de dispositivo (começa por \\.\).

ArgumentNullException

file é Nothing ou uma corda vazia.

PathTooLongException

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

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

IOException

O ficheiro está em uso.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

FileNotFoundException

O ficheiro não existe.

UnauthorizedAccessException

O utilizador não tem permissão para eliminar o ficheiro ou este é apenas de leitura.

Exemplos

Este exemplo elimina o ficheiro Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Este exemplo elimina o ficheiro Test.txt e permite ao utilizador confirmar que o ficheiro deve ser eliminado.

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

Este exemplo apaga o ficheiro Test.txt e envia-o para o Contentor de Reciclagem.

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

Observações

A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.DeleteFile método.

Para	Veja
Para eliminar um ficheiro	Como: Eliminar um Ficheiro

Ver também

Aplica-se a

DeleteFile(String, UIOption, RecycleOption)

Exclui um arquivo.

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

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

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

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

Parâmetros

file: String

Nome e caminho do ficheiro a eliminar.

showUI: UIOption

Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

recycle: RecycleOption

Se o ficheiro apagado deve ou não ser enviado para o Contentor de Reciclagem. A predefinição é RecycleOption.DeletePermanently.

Exceções

ArgumentException

ArgumentNullException

file é Nothing ou uma corda vazia.

PathTooLongException

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

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

IOException

O ficheiro está em uso.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

FileNotFoundException

O ficheiro não existe.

UnauthorizedAccessException

O utilizador não tem permissão para eliminar o ficheiro ou este é apenas de leitura.

Exemplos

Este exemplo elimina o ficheiro Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Este exemplo elimina o ficheiro Test.txt e permite ao utilizador confirmar que o ficheiro deve ser eliminado.

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

Este exemplo apaga o ficheiro Test.txt e envia-o para o Contentor de Reciclagem.

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

Observações

Os parâmetros showUI e recycle não são suportados em aplicações que não sejam interativas pelo utilizador, como a Windows Services.

A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.DeleteFile método.

Para	Veja
Para eliminar um ficheiro	Como: Eliminar um Ficheiro

Ver também

Aplica-se a

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Exclui um arquivo.

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

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

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

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

Parâmetros

file: String

Nome e caminho do ficheiro a eliminar.

showUI: UIOption

Se deve acompanhar visualmente o progresso da operação. A predefinição é UIOption.OnlyErrorDialogs.

recycle: RecycleOption

Se o ficheiro apagado deve ou não ser enviado para o Contentor de Reciclagem. A predefinição é RecycleOption.DeletePermanently.

onUserCancel: UICancelOption

Especifica se uma exceção é lançada quando o utilizador cancela a operação. A predefinição é UICancelOption.ThrowException.

Exceções

ArgumentException

ArgumentNullException

file é Nothing ou uma corda vazia.

PathTooLongException

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

NotSupportedException

Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.

IOException

O ficheiro está em uso.

SecurityException

O utilizador não tem as permissões necessárias para visualizar o caminho.

FileNotFoundException

O ficheiro não existe.

UnauthorizedAccessException

O utilizador não tem permissão para eliminar o ficheiro ou este é apenas de leitura.

OperationCanceledException

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

Exemplos

Este exemplo elimina o ficheiro Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Este exemplo elimina o ficheiro Test.txt e permite ao utilizador confirmar que o ficheiro deve ser eliminado.

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

Este exemplo apaga o ficheiro Test.txt e envia-o para o Contentor de Reciclagem.

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

Observações

Os parâmetros showUI, recycle e onUserCancel não são suportados em aplicações que não são interativas para o utilizador, como a Windows Services.

A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.DeleteFile método.

Para	Veja
Para eliminar um ficheiro	Como: Eliminar um Ficheiro

Ver também

Aplica-se a

Comentários

Esta página foi útil?