FileShare 列挙体

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

FileShare 列挙体

同一のファイルに対して他の FileStream オブジェクトが保有できるアクセスの種類を制御する定数を格納します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

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

Visual Basic (宣言)

<SerializableAttribute> _
<FlagsAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration FileShare

Visual Basic (使用法)

Dim instance As FileShare

C#

[SerializableAttribute] 
[FlagsAttribute] 
[ComVisibleAttribute(true)] 
public enum FileShare

C++

[SerializableAttribute] 
[FlagsAttribute] 
[ComVisibleAttribute(true)] 
public enum class FileShare

J#

/** @attribute SerializableAttribute() */ 
/** @attribute FlagsAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum FileShare

JScript

SerializableAttribute 
FlagsAttribute 
ComVisibleAttribute(true) 
public enum FileShare

メンバ

	メンバ名	説明
	Delete	後続のファイルの削除を許可します。
	Inheritable	ファイル ハンドルを子プロセスで継承できるようにします。Win32 では、直接サポートされません。
	None	現在のファイルの共有を解除します。ファイルを閉じるまで、このプロセスまたは別のプロセスがファイルを開く要求をしても失敗します。
	Read	後続の読み取り用のファイルを開くことを許可します。このフラグが指定されていない場合は、ファイルを閉じるまで、このプロセスまたは別のプロセスが読み取り用のファイルを開く要求をしても失敗します。ただし、このフラグが指定されていても、ファイルにアクセスするために追加のアクセス許可が必要になることがあります。
	ReadWrite	後続の読み取り用または書き込み用のファイルを開くことを許可します。このフラグが指定されていない場合は、ファイルを閉じるまで、このプロセスまたは別のプロセスが読み取り用または書き込み用のファイルを開く要求をしても失敗します。ただし、このフラグが指定されていても、ファイルにアクセスするために追加のアクセス許可が必要になることがあります。
	Write	後続の書き込み用のファイルを開くことを許可します。このフラグが指定されていない場合は、ファイルを閉じるまで、このプロセスまたは別のプロセスが書き込み用のファイルを開く要求をしても失敗します。ただし、このフラグが指定されていても、ファイルにアクセスするために追加のアクセス許可が必要になることがあります。

解説

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

通常、この列挙体を使用して、同一のファイルから 2 つのプロセスを同時に読み取れるようにするかを定義します。たとえば、ファイルが開かれていて Readが指定されている場合、ほかのユーザーはファイルを読み取り用として開くことができますが、書き込み用として開くことはできません。

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

使用例

次の FileStream コンストラクタは、既存のファイルを開き、ほかのユーザーに読み取り専用のアクセス権限 (Read) を与えます。

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
方法 : 新しく作成されたデータ ファイルに対して読み書きする