FileSystem.DeleteFile メソッド

定義

名前空間:: Microsoft.VisualBasic.FileIO

アセンブリ:: Microsoft.VisualBasic.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ファイルを削除します。

オーバーロード

名前	説明
DeleteFile(String)	ファイルを削除します。
DeleteFile(String, UIOption, RecycleOption)	ファイルを削除します。
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	ファイルを削除します。

DeleteFile(String)

ファイルを削除します。

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

パスは、次のいずれかの理由で無効です。長さ 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 メソッドを含むタスクの例を示します。

ターゲット	参照先
ファイルを削除するには	方法: Visual Basic

適用対象

DeleteFile(String, UIOption, RecycleOption)

ファイルを削除します。

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 Services などのユーザー対話型ではないアプリケーションではサポートされていません。

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

ターゲット	参照先
ファイルを削除するには	方法: Visual Basic

こちらもご覧ください

適用対象

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

ファイルを削除します。

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 Services などのユーザー対話型ではないアプリケーションではサポートされていません。

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

ターゲット	参照先
ファイルを削除するには	方法: Visual Basic

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?