FileSystem.DeleteFile Метод

Определение

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

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

DeleteFile(String)	Удаляет файл.
DeleteFile(String, UIOption, RecycleOption)	Удаляет файл.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Удаляет файл.

DeleteFile(String)

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

FileSystem.vb

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

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)

Параметры

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

DeleteFile(String, UIOption, RecycleOption)

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

FileSystem.vb

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

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)

Параметры

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 метод .

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

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

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

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

FileSystem.vb

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

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)

Параметры

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 метод .

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

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

• UICancelOption
• RecycleOption
• UIOption