FileSystemProxy.DeleteFile Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Odstraní soubor.
Přetížení
DeleteFile(String) |
Odstraní soubor. |
DeleteFile(String, UIOption, RecycleOption) |
Odstraní soubor. |
DeleteFile(String, UIOption, RecycleOption, UICancelOption) |
Odstraní soubor. |
DeleteFile(String)
Odstraní soubor.
public:
void DeleteFile(System::String ^ file);
public void DeleteFile (string file);
member this.DeleteFile : string -> unit
Public Sub DeleteFile (file As String)
Parametry
- file
- String
Název a cesta k souboru, který se má odstranit.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; má koncové lomítko, kde musí být zadán soubor; nebo se jedná o cestu k zařízení (začíná na \\.\).
file
je Nothing
nebo prázdný řetězec.
Cesta překračuje maximální délku definovanou systémem.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Soubor se používá.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Soubor neexistuje.
Uživatel nemá oprávnění k odstranění souboru nebo je soubor jen pro čtení.
Příklady
Tento příklad odstraní soubor Test.txt
.
My.Computer.FileSystem.DeleteFile("C:\test.txt")
Tento příklad odstraní soubor Test.txt
a umožní uživateli potvrdit, že by měl být soubor odstraněn.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.AllDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Tento příklad odstraní soubor Test.txt
a odešle ho do koše.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.OnlyErrorDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Poznámky
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.DeleteFile
.
Záměr | Seznamte se s |
---|---|
Odstranění souboru | Postupy: Odstranění souboru |
Viz také
Platí pro
DeleteFile(String, UIOption, RecycleOption)
Odstraní soubor.
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)
Parametry
- file
- String
Název a cesta k souboru, který se má odstranit.
- showUI
- UIOption
Zda se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs
.
- recycle
- RecycleOption
Určuje, jestli má být odstraněný soubor odeslán do koše. Výchozí je RecycleOption.DeletePermanently
.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; má koncové lomítko, kde musí být zadán soubor; nebo se jedná o cestu k zařízení (začíná na \\.\).
file
je Nothing
nebo prázdný řetězec.
Cesta překračuje maximální délku definovanou systémem.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Soubor se používá.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Soubor neexistuje.
Uživatel nemá oprávnění k odstranění souboru nebo je soubor jen pro čtení.
Příklady
Tento příklad odstraní soubor Test.txt
.
My.Computer.FileSystem.DeleteFile("C:\test.txt")
Tento příklad odstraní soubor Test.txt
a umožní uživateli potvrdit, že by měl být soubor odstraněn.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.AllDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Tento příklad odstraní soubor Test.txt
a odešle ho do koše.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.OnlyErrorDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Poznámky
Parametry showUI
a recycle
nejsou podporovány v aplikacích, které nejsou interaktivní uživatelem, jako jsou služby systému Windows.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.DeleteFile
.
Záměr | Seznamte se s |
---|---|
Odstranění souboru | Postupy: Odstranění souboru |
Viz také
Platí pro
DeleteFile(String, UIOption, RecycleOption, UICancelOption)
Odstraní soubor.
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)
Parametry
- file
- String
Název a cesta k souboru, který se má odstranit.
- showUI
- UIOption
Zda se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs
.
- recycle
- RecycleOption
Určuje, jestli má být odstraněný soubor odeslán do koše. Výchozí je RecycleOption.DeletePermanently
.
- onUserCancel
- UICancelOption
Určuje, zda se při zrušení operace uživatelem vyvolá výjimka. Výchozí je UICancelOption.ThrowException
.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; má koncové lomítko, kde musí být zadán soubor; nebo se jedná o cestu k zařízení (začíná na \\.\).
file
je Nothing
nebo prázdný řetězec.
Cesta překračuje maximální délku definovanou systémem.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Soubor se používá.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Soubor neexistuje.
Uživatel nemá oprávnění k odstranění souboru nebo je soubor jen pro čtení.
Uživatel zrušil operaci a onUserCancel
je nastavený na ThrowException.
Příklady
Tento příklad odstraní soubor Test.txt
.
My.Computer.FileSystem.DeleteFile("C:\test.txt")
Tento příklad odstraní soubor Test.txt
a umožní uživateli potvrdit, že by měl být soubor odstraněn.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.AllDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Tento příklad odstraní soubor Test.txt
a odešle ho do koše.
My.Computer.FileSystem.DeleteFile(
"C:\test.txt",
FileIO.UIOption.OnlyErrorDialogs,
FileIO.RecycleOption.SendToRecycleBin,
FileIO.UICancelOption.ThrowException)
Poznámky
Parametry showUI
, recycle
a onUserCancel
nejsou podporovány v aplikacích, které nejsou interaktivní uživatelem, jako jsou služby systému Windows.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.DeleteFile
.
Záměr | Seznamte se s |
---|---|
Odstranění souboru | Postupy: Odstranění souboru |
Viz také
- UICancelOption
- RecycleOption
- UIOption
- Objekty (Visual Basic)
- Postupy: Odstranění souboru v jazyce Visual Basic