Поделиться через


FileSystemProxy.DeleteFile Метод

Определение

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

Перегрузки

DeleteFile(String)

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

DeleteFile(String, UIOption, RecycleOption)

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

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

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

DeleteFile(String)

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

public:
 void DeleteFile(System::String ^ file);
public void DeleteFile (string file);
member this.DeleteFile : string -> unit
Public Sub DeleteFile (file As String)

Параметры

file
String

Путь к удаляемому файлу и его имя.

Исключения

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

Параметр file имеет значение Nothing или является пустой строкой.

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

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

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

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

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

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

Примеры

В этом примере удаляется файл 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 .

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

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

Применяется к

DeleteFile(String, UIOption, RecycleOption)

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

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.

Исключения

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

Параметр file имеет значение Nothing или является пустой строкой.

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

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

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

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

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

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

Примеры

В этом примере удаляется файл 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 .

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

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

Применяется к

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

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

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.

Исключения

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

Параметр file имеет значение Nothing или является пустой строкой.

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

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

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

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

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

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

Пользователь отменил операцию, и для параметра 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 .

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

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

Применяется к