FileSystem.DeleteFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Usuwa plik.

Przeciążenia

DeleteFile(String)	Usuwa plik.
DeleteFile(String, UIOption, RecycleOption)	Usuwa plik.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Usuwa plik.

DeleteFile(String)

Źródło:

FileSystem.vb

Usuwa plik.

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

Nazwa i ścieżka pliku do usunięcia.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; zawiera ukośnik końcowy, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest lub pusty Nothing ciąg.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

IOException

Plik jest używany.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

FileNotFoundException

Plik nie istnieje.

UnauthorizedAccessException

Użytkownik nie ma uprawnień do usuwania pliku lub plik jest tylko do odczytu.

Przykłady

W tym przykładzie usunięto plik Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Ten przykład usuwa plik Test.txt i umożliwia użytkownikowi potwierdzenie usunięcia pliku.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Ten przykład usuwa plik Test.txt i wysyła go do Kosza.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Uwagi

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Porady: usuwanie pliku w Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Źródło:

FileSystem.vb

Usuwa plik.

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

Nazwa i ścieżka pliku do usunięcia.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Niezależnie od tego, czy usunięty plik powinien zostać wysłany do Kosza. Wartość domyślna to RecycleOption.DeletePermanently.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; zawiera ukośnik końcowy, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest lub pusty Nothing ciąg.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

IOException

Plik jest używany.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

FileNotFoundException

Plik nie istnieje.

UnauthorizedAccessException

Użytkownik nie ma uprawnień do usuwania pliku lub plik jest tylko do odczytu.

Przykłady

W tym przykładzie usunięto plik Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Ten przykład usuwa plik Test.txt i umożliwia użytkownikowi potwierdzenie usunięcia pliku.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Ten przykład usuwa plik Test.txt i wysyła go do Kosza.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Uwagi

Parametry showUI i recycle nie są obsługiwane w aplikacjach, które nie są interaktywne dla użytkownika, takie jak usługi systemu Windows.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Porady: usuwanie pliku w Visual Basic

Zobacz też

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Źródło:

FileSystem.vb

Usuwa plik.

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

Nazwa i ścieżka pliku do usunięcia.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Niezależnie od tego, czy usunięty plik powinien zostać wysłany do Kosza. Wartość domyślna to RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Określa, czy wyjątek jest zgłaszany, gdy użytkownik anuluje operację. Wartość domyślna to UICancelOption.ThrowException.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; zawiera ukośnik końcowy, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest lub pusty Nothing ciąg.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

IOException

Plik jest używany.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

FileNotFoundException

Plik nie istnieje.

UnauthorizedAccessException

Użytkownik nie ma uprawnień do usuwania pliku lub plik jest tylko do odczytu.

OperationCanceledException

Użytkownik anulował operację i onUserCancel ma wartość ThrowException.

Przykłady

W tym przykładzie usunięto plik Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Ten przykład usuwa plik Test.txt i umożliwia użytkownikowi potwierdzenie usunięcia pliku.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Ten przykład usuwa plik Test.txt i wysyła go do Kosza.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Uwagi

Parametry showUI, recyclei onUserCancel nie są obsługiwane w aplikacjach, które nie są interakcyjne, takie jak usługi systemu Windows.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Porady: usuwanie pliku w Visual Basic

Zobacz też

• UICancelOption
• RecycleOption
• UIOption