FileSystemProxy.DeleteFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

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

ArgumentException

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

ArgumentNullException

file je Nothing nebo prázdný řetězec.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

IOException

Soubor se používá.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

FileNotFoundException

Soubor neexistuje.

UnauthorizedAccessException

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é

• Objekty (Visual Basic)
• Postupy: Odstranění souboru v jazyce Visual Basic

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

ArgumentException

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

ArgumentNullException

file je Nothing nebo prázdný řetězec.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

IOException

Soubor se používá.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

FileNotFoundException

Soubor neexistuje.

UnauthorizedAccessException

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é

• RecycleOption
• UIOption
• Objekty (Visual Basic)
• Postupy: Odstranění souboru v jazyce Visual Basic

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

ArgumentException

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

ArgumentNullException

file je Nothing nebo prázdný řetězec.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

IOException

Soubor se používá.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

FileNotFoundException

Soubor neexistuje.

UnauthorizedAccessException

Uživatel nemá oprávnění k odstranění souboru nebo je soubor jen pro čtení.

OperationCanceledException

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é

• UICancelOption
• RecycleOption
• UIOption
• Objekty (Visual Basic)
• Postupy: Odstranění souboru v jazyce Visual Basic