FileMode 列挙体

.NET Framework クラス ライブラリ リファレンス

FileMode 列挙体

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration FileMode

Visual Basic (使用法)

Dim instance As FileMode

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum FileMode

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class FileMode

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum FileMode

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum FileMode

メンバ

	メンバ名	説明
	Append	ファイルが存在する場合はそのファイルを開き、ファイルの末尾をシークします。存在しない場合は新しいファイルを作成します。FileMode.Append は、必ず FileAccess.Writeと共に使用します。読み込み操作を実行しようとしてもすべて失敗し、ArgumentException がスローされます。
	Create	オペレーティング システムが新しいファイルを作成することを指定します。ファイルが既に存在する場合は上書きされます。この操作には FileIOPermissionAccess.Write が必要です。System.IO.FileMode.Create は、ファイルが存在しない場合は CreateNew を使用した要求、ファイルが存在する場合は Truncate を使用した要求と等価です。
	CreateNew	オペレーティング システムが新しいファイルを作成することを指定します。この操作には FileIOPermissionAccess.Write が必要です。ファイルが既に存在する場合は IOException がスローされます。
	Open	オペレーティング システムが既存のファイルを開くことを指定します。ファイルを開けるかどうかは、FileAccess で指定される値によって異なります。ファイルが存在しない場合は System.IO.FileNotFoundException がスローされます。
	OpenOrCreate	ファイルが存在する場合はオペレーティング システムがそのファイルを開き、存在しない場合は新しいファイルを作成することを指定します。ファイルを FileAccess.Read で開く場合は FileIOPermissionAccess.Read が必要です。ファイル アクセスが FileAccess.Write または FileAccess.ReadWriteの場合は、FileIOPermissionAccess.Write が必要です。ファイル アクセスが FileAccess.Append の場合は、FileIOPermissionAccess.Append が必要です。
	Truncate	オペレーティング システムが既存のファイルを開くことを指定します。ファイルは、開いた後にサイズが 0 バイトになるように切り捨てられます。この操作には FileIOPermissionAccess.Write が必要です。Truncate を使用して開いたファイルから読み取ろうとすると、例外が発生します。

解説

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

FileMode パラメータは、ファイルを開く方法を制御するために、FileStream の多数のコンストラクタ、IsolatedStorageFileStream、および File や FileInfo の Open メソッドに指定します。

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

使用例

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

Visual Basic

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

C#

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

C++

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read
 );

J#

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

JScript

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
System.IO 名前空間
File.Open
FileInfo.Open
FileStream
IsolatedStorageFileStream
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
基本のファイル I/O
方法 : 新しく作成されたデータ ファイルに対して読み書きする