FileMode 列挙型

定義

名前空間:
System.IO
アセンブリ:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
アセンブリ:
mscorlib.dll
アセンブリ:
System.IO.FileSystem.Primitives.dll
アセンブリ:
netstandard.dll

オペレーティング システムでファイルを開く方法を指定します。

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
継承
Object
ValueType
Enum
FileMode
属性
SerializableAttribute ComVisibleAttribute

フィールド

名前 値 説明
CreateNew 1

オペレーティング システムで新しいファイルを作成することを指定します。 これには Write アクセス許可が必要です。 ファイルが既に存在する場合は、 IOException 例外がスローされます。
Create 2

オペレーティング システムで新しいファイルを作成することを指定します。 ファイルが既に存在する場合は、上書きされます。 これには Write アクセス許可が必要です。 FileMode.Create は、ファイルが存在しない場合は CreateNew を使用するように要求するのと同じです。それ以外の場合は、 Truncateを使用します。 ファイルが既に存在していても非表示のファイルである場合は、 UnauthorizedAccessException 例外がスローされます。
Open 3

オペレーティング システムが既存のファイルを開く必要があることを指定します。 ファイルを開く機能は、 FileAccess 列挙体で指定された値によって異なります。 ファイルが存在しない場合、 FileNotFoundException 例外がスローされます。
OpenOrCreate 4

オペレーティング システムが存在する場合にファイルを開くことを指定します。それ以外の場合は、新しいファイルを作成する必要があります。 FileAccess.Readでファイルを開く場合は、Readアクセス許可が必要です。 ファイル アクセスが FileAccess.Writeされている場合は、 Write アクセス許可が必要です。 ファイルを FileAccess.ReadWriteで開く場合は、 Read と Write の両方のアクセス許可が必要です。
Truncate 5

オペレーティング システムが既存のファイルを開く必要があることを指定します。 ファイルを開くときに、サイズが 0 バイトになるように切り捨てる必要があります。 これには Write アクセス許可が必要です。 FileMode.Truncateで開かれたファイルから読み取ろうとすると、ArgumentException例外が発生します。
Append 6

ファイルが存在し、ファイルの末尾までシークする場合は開くか、新しいファイルを作成します。 これには Append アクセス許可が必要です。 FileMode.Append は、 FileAccess.Writeと組み合わせてのみ使用できます。 ファイルの末尾の前の位置をシークしようとすると、 IOException 例外がスローされ、読み取ろうとしても失敗し、 NotSupportedException 例外がスローされます。

例

次の FileStream コンストラクターは、既存のファイル (FileMode.Open) を開きます。

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

注釈

ファイルの作成とファイルへのテキストの書き込みの例については、「 方法: ファイルにテキストを書き込む」を参照してください。 ファイルからテキストを読み取る例については、「 方法: ファイルからテキストを読み取る」を参照してください。 バイナリ ファイルの読み取りとバイナリ ファイルへの書き込みの例については、「 方法: 新しく作成されたデータ ファイルの読み取りと書き込み」を参照してください。

FileMode パラメーターは、FileStream、IsolatedStorageFileStream、およびFileのOpenメソッドの多くのコンストラクターで指定され、ファイルの開き方を制御FileInfo。

FileMode パラメーターは、ファイルを上書きするか、作成するか、開くか、またはその組み合わせを制御します。 Openを使用して既存のファイルを開きます。 ファイルに追加するには、 Appendを使用します。 ファイルを切り捨てるか、存在しない場合はファイルを作成するには、 Createを使用します。

適用対象

こちらもご覧ください