FileSystemProxy.DeleteFile メソッド

  • リファレンス

定義

名前空間:
Microsoft.VisualBasic.MyServices
アセンブリ:
Microsoft.VisualBasic.dll
アセンブリ:
Microsoft.VisualBasic.Forms.dll

ファイルを削除します。

オーバーロード

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

削除対象のファイルの名前とパス。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。

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 示します。

終了 解決方法については、
ファイルを削除するには 方法: ファイルを削除する

こちらもご覧ください

適用対象

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 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。

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 示します。

終了 解決方法については、
ファイルを削除するには 方法: ファイルを削除する

こちらもご覧ください

適用対象

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 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。

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)

注釈

recycle、showUI、および onUserCancel パラメーターは、Windows サービスなどのユーザー対話型ではないアプリケーションではサポートされていません。

次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.DeleteFile 示します。

終了 解決方法については、
ファイルを削除するには 方法: ファイルを削除する

こちらもご覧ください

適用対象