FileSystemProxy.DeleteFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイルを削除します。
オーバーロード
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
削除対象のファイルの名前とパス。
例外
パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。
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
です。
例外
パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。
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
です。
例外
パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。ファイルを指定する必要がある末尾のスラッシュがあります。または、デバイス パスです (\\.\で始まります)。
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)
注釈
recycle
、showUI
、および onUserCancel
パラメーターは、Windows サービスなどのユーザー対話型ではないアプリケーションではサポートされていません。
次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.DeleteFile
示します。
終了 | 解決方法については、 |
---|---|
ファイルを削除するには | 方法: ファイルを削除する |
こちらもご覧ください
適用対象
.NET