FileSystem.DeleteFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Odstraní soubor.

Přetížení

Name	Description
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 je to cesta 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 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 se má soubor odstranit.

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 úkolu zahrnujícího metodu My.Computer.FileSystem.DeleteFile .

To	Podívejte se
Odstranění souboru	: Odstranění souboru v 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

Zda chcete vizuálně sledovat průběh operace. Výchozí hodnota je UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Jestli se má odstraněný soubor odeslat do koše, nebo ne. Výchozí hodnota 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 je to cesta 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 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 se má soubor odstranit.

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, například Windows Services.

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

To	Podívejte se
Odstranění souboru	: Odstranění souboru v 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

Zda chcete vizuálně sledovat průběh operace. Výchozí hodnota je UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Jestli se má odstraněný soubor odeslat do koše, nebo ne. Výchozí hodnota je RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Určuje, zda je vyvolán výjimka při zrušení operace uživatelem. Výchozí hodnota 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 je to cesta 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 jen pro čtení.

OperationCanceledException

Uživatel operaci zrušil a onUserCancel je nastaven na ThrowExceptionhodnotu .

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 se má soubor odstranit.

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ími uživateli, jako jsou například služby Windows Services.

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

To	Podívejte se
Odstranění souboru	: Odstranění souboru v Visual Basic

Viz také

• UICancelOption
• RecycleOption
• UIOption