FileSystem.DeleteFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.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)

Zdroj:

FileSystem.vb

Odstraní soubor.

public:
 static void DeleteFile(System::String ^ file);

public static void DeleteFile (string file);

static member DeleteFile : string -> unit

Public Shared 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řesahuje systémem definovanou maximální délku.

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říklad úlohy zahrnující metodu My.Computer.FileSystem.DeleteFile .

Záměr	Seznamte se s
Odstranění souboru	Postupy: Odstranění souboru v jazyce Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Zdroj:

FileSystem.vb

Odstraní soubor.

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 -> unit

Public Shared 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

Jestli 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řesahuje systémem definovanou maximální délku.

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ími uživateli, jako jsou služby systému Windows.

Následující tabulka uvádí příklad úlohy zahrnující metodu My.Computer.FileSystem.DeleteFile .

Záměr	Seznamte se s
Odstranění souboru	Postupy: Odstranění souboru v jazyce Visual Basic

Viz také

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Zdroj:

FileSystem.vb

Odstraní soubor.

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 -> unit

Public Shared 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

Jestli 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, jestli 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řesahuje systémem definovanou maximální délku.

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í pro uživatele, jako jsou služby systému Windows.

Následující tabulka uvádí příklad úlohy zahrnující metodu My.Computer.FileSystem.DeleteFile .

Záměr	Seznamte se s
Odstranění souboru	Postupy: Odstranění souboru v jazyce Visual Basic

Viz také

• UICancelOption
• RecycleOption
• UIOption