Sdílet prostřednictvím


FileSystemProxy.DeleteFile Metoda

Definice

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, recyclea 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é

Platí pro