FileSystem.DeleteFile Метод

Определение

Удаляет файл.Deletes a file.

Перегрузки

DeleteFile(String)

Удаляет файл.Deletes a file.

DeleteFile(String, UIOption, RecycleOption)

Удаляет файл.Deletes a file.

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Удаляет файл.Deletes a file.

DeleteFile(String)

Удаляет файл.Deletes a file.

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

Путь к удаляемому файлу и его имя.Name and path of the file to be deleted.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо оканчивается косой чертой там, где должен быть указан файл, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

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

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Файл уже используется.The file is in use.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Файл не существует.The file does not exist.

Пользователь не имеет разрешения на удаление файла, или файл доступен только для чтения.The user does not have permission to delete the file or the file is read-only.

Примеры

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

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

Этот пример удаляет файл Test.txt и позволяет пользователю подтвердить удаление файла.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Комментарии

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.DeleteFile.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

КомуTo См.See
Удаление файлаTo delete a file Практическое руководство. Удаление файла в Visual BasicHow to: Delete a File in Visual Basic

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

DeleteFile(String, UIOption, RecycleOption)

Удаляет файл.Deletes a file.

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

Путь к удаляемому файлу и его имя.Name and path of the file to be deleted.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Указывает, нужно ли перемещать удаленный файл в Корзину.Whether or not the deleted file should be sent to the Recycle Bin. Значение по умолчанию — RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо оканчивается косой чертой там, где должен быть указан файл, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

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

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Файл уже используется.The file is in use.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Файл не существует.The file does not exist.

Пользователь не имеет разрешения на удаление файла, или файл доступен только для чтения.The user does not have permission to delete the file or the file is read-only.

Примеры

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

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

Этот пример удаляет файл Test.txt и позволяет пользователю подтвердить удаление файла.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Комментарии

Параметры showUI и recycle не поддерживаются в приложениях, которые не являются интерактивными пользователями, например службами Windows.The showUI and recycle parameters are not supported in applications that are not user interactive, such as Windows Services.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.DeleteFile.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

КомуTo См.See
Удаление файлаTo delete a file Практическое руководство. Удаление файла в Visual BasicHow to: Delete a File in Visual Basic

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Удаляет файл.Deletes a file.

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

Путь к удаляемому файлу и его имя.Name and path of the file to be deleted.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Указывает, нужно ли перемещать удаленный файл в Корзину.Whether or not the deleted file should be sent to the Recycle Bin. Значение по умолчанию — RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

onUserCancel
UICancelOption

Указывает, выдается ли исключение, когда пользователь отменяет операцию.Specifies whether or not an exception is thrown when the user cancels the operation. Значение по умолчанию — UICancelOption.ThrowException.Default is UICancelOption.ThrowException.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо оканчивается косой чертой там, где должен быть указан файл, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

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

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Файл уже используется.The file is in use.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Файл не существует.The file does not exist.

Пользователь не имеет разрешения на удаление файла, или файл доступен только для чтения.The user does not have permission to delete the file or the file is read-only.

Пользователь отменил операцию, и для параметра onUserCancel установлено значение ThrowException.The user cancelled the operation and onUserCancel is set to ThrowException.

Примеры

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

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

Этот пример удаляет файл Test.txt и позволяет пользователю подтвердить удаление файла.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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

В этом примере файл Test.txt удаляется и отправляется в корзину.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Комментарии

Параметры showUI, recycleи onUserCancel не поддерживаются в приложениях, которые не являются интерактивными пользователями, такими как службы Windows.The showUI, recycle, and onUserCancel parameters are not supported in applications that are not user interactive, such as Windows Services.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.DeleteFile.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

КомуTo См.See
Удаление файлаTo delete a file Практическое руководство. Удаление файла в Visual BasicHow to: Delete a File in Visual Basic

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

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