FileSystemProxy.DeleteFile Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Удаляет файл.

Перегрузки

Имя	Описание
DeleteFile(String)	Удаляет файл.
DeleteFile(String, UIOption, RecycleOption)	Удаляет файл.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Удаляет файл.

DeleteFile(String)

Исходный код:

FileSystemProxy.vb

Удаляет файл.

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

public void DeleteFile(string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

Параметры

file

String

Имя и путь к файлу для удаления.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; Он имеет конечную косую черту, в которой должен быть указан файл; или это путь к устройству (начинается с \\.\).

ArgumentNullException

file имеет Nothing или пустую строку.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

IOException

Файл используется.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

FileNotFoundException

Файл не существует.

UnauthorizedAccessException

У пользователя нет разрешения на удаление файла или файл доступен только для чтения.

Примеры

В этом примере удаляется файл Test.txt.

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

В этом примере файл Test.txt удаляется и пользователь может подтвердить, что файл должен быть удален.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.

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

Комментарии

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.DeleteFile .

Кому	Смотри
Удаление файла	Практическое руководство. Удаление файла

См. также раздел

• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Исходный код:

FileSystemProxy.vb

Удаляет файл.

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)

Параметры

file

String

Имя и путь к файлу для удаления.

showUI

UIOption

Следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Следует ли отправлять удаленный файл в корзину. По умолчанию — RecycleOption.DeletePermanently.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; Он имеет конечную косую черту, в которой должен быть указан файл; или это путь к устройству (начинается с \\.\).

ArgumentNullException

file имеет Nothing или пустую строку.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

IOException

Файл используется.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

FileNotFoundException

Файл не существует.

UnauthorizedAccessException

У пользователя нет разрешения на удаление файла или файл доступен только для чтения.

Примеры

В этом примере удаляется файл Test.txt.

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

В этом примере файл Test.txt удаляется и пользователь может подтвердить, что файл должен быть удален.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.

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

Комментарии

Параметры showUI и recycle не поддерживаются в приложениях, которые не являются пользовательскими интерактивными, например службами Windows.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.DeleteFile .

Кому	Смотри
Удаление файла	Практическое руководство. Удаление файла

См. также раздел

• RecycleOption
• UIOption
• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Исходный код:

FileSystemProxy.vb

Удаляет файл.

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)

Параметры

file

String

Имя и путь к файлу для удаления.

showUI

UIOption

Следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Следует ли отправлять удаленный файл в корзину. По умолчанию — RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Указывает, возникает ли исключение при отмене операции пользователем. По умолчанию — UICancelOption.ThrowException.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; Он имеет конечную косую черту, в которой должен быть указан файл; или это путь к устройству (начинается с \\.\).

ArgumentNullException

file имеет Nothing или пустую строку.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

IOException

Файл используется.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

FileNotFoundException

Файл не существует.

UnauthorizedAccessException

У пользователя нет разрешения на удаление файла или файл доступен только для чтения.

OperationCanceledException

Пользователь отменил операцию и onUserCancel имеет значение ThrowException.

Примеры

В этом примере удаляется файл Test.txt.

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

В этом примере файл Test.txt удаляется и пользователь может подтвердить, что файл должен быть удален.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.

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

Комментарии

Параметры showUI, recycle и onUserCancel не поддерживаются в приложениях, которые не являются пользовательскими интерактивными, например службами Windows.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.DeleteFile .

Кому	Смотри
Удаление файла	Практическое руководство. Удаление файла

См. также раздел

• UICancelOption
• RecycleOption
• UIOption
• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic