Udostępnij za pośrednictwem


FileSystem.DeleteFile Metoda

Definicja

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
Źródło:
FileSystem.vb
Ź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

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

file jest lub pusty Nothing ciąg.

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

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

Plik jest używany.

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

Plik nie istnieje.

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

Dotyczy

DeleteFile(String, UIOption, RecycleOption)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Ź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

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

file jest lub pusty Nothing ciąg.

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

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

Plik jest używany.

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

Plik nie istnieje.

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ż

Dotyczy

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Ź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

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

file jest lub pusty Nothing ciąg.

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

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

Plik jest używany.

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

Plik nie istnieje.

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

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ż

Dotyczy