FileSystem.DeleteFile Método
Definição
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 |
