FileSystemProxy.DeleteFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.MyServices

Zestaw:

Microsoft.VisualBasic.Forms.dll

Usuwa plik.

Przeciążenia

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

DeleteFile(String)

Usuwa plik.

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

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; ma końcowy ukośnik, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest Nothing ciągiem lub ciągiem pustym.

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 usunięcia pliku lub plik jest tylko do odczytu.

Przykłady

Ten przykład usuwa 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łady zadań obejmujących metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Instrukcje: Usuwanie pliku

Zobacz też

• Obiekty (Visual Basic)
• Porady: usuwanie pliku w Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Usuwa plik.

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

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

showUI

UIOption

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

recycle

RecycleOption

Określa, 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; ma końcowy ukośnik, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest Nothing ciągiem lub ciągiem pustym.

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 usunięcia pliku lub plik jest tylko do odczytu.

Przykłady

Ten przykład usuwa 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łady zadań obejmujących metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Instrukcje: Usuwanie pliku

Zobacz też

• RecycleOption
• UIOption
• Obiekty (Visual Basic)
• Porady: usuwanie pliku w Visual Basic

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Usuwa plik.

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

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

showUI

UIOption

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

recycle

RecycleOption

Określa, 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; ma końcowy ukośnik, w którym należy określić plik; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

file jest Nothing ciągiem lub ciągiem pustym.

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 usunięcia pliku lub plik jest tylko do odczytu.

OperationCanceledException

Użytkownik anulował operację i onUserCancel jest ustawiony na ThrowExceptionwartość .

Przykłady

Ten przykład usuwa 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ą interaktywne dla użytkownika, takie jak usługi systemu Windows.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.DeleteFile .

Działanie	Zobacz
Aby usunąć plik	Instrukcje: Usuwanie pliku

Zobacz też

• UICancelOption
• RecycleOption
• UIOption
• Obiekty (Visual Basic)
• Porady: usuwanie pliku w Visual Basic