FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、およびバッファ サイズを使用して初期化します。
名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文
'宣言
Public Sub New ( _
path As String, _
mode As FileMode, _
access As FileAccess, _
share As FileShare, _
bufferSize As Integer _
)
'使用
Dim path As String
Dim mode As FileMode
Dim access As FileAccess
Dim share As FileShare
Dim bufferSize As Integer
Dim instance As New FileStream(path, mode, access, share, bufferSize)
public FileStream (
string path,
FileMode mode,
FileAccess access,
FileShare share,
int bufferSize
)
public:
FileStream (
String^ path,
FileMode mode,
FileAccess access,
FileShare share,
int bufferSize
)
public FileStream (
String path,
FileMode mode,
FileAccess access,
FileShare share,
int bufferSize
)
public function FileStream (
path : String,
mode : FileMode,
access : FileAccess,
share : FileShare,
bufferSize : int
)
パラメータ
- path
現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。
- mode
ファイルを開く方法または作成する方法を決定する FileMode 定数。
- access
FileStream オブジェクトがファイルにアクセスする方法を決定する FileAccess 定数。これは、FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得します。path にディスク ファイルが指定されている場合、CanSeek は true になります。
- share
プロセスによるファイルの共有方法を決定する FileShare 定数。
- bufferSize
バッファ サイズを示す 0 より大きな正の Int32 値。bufferSize 値には 0 から 8 を設定します。実際のバッファ サイズは 8 バイトに設定されます。
例外
| 例外の種類 | 条件 |
|---|---|
path が null 参照 (Visual Basic では Nothing) です。 |
|
path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。 または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。 |
|
path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。 |
|
ArgumentException |
path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。 |
bufferSize が負の値またはゼロです。 または mode、access、または share に無効な値が含まれています。 |
|
ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。 |
|
FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。 または システムで Windows 98 または Windows 98 Second Edition を実行しており、share が FileShare.Delete に設定されています。 または ストリームは閉じられています。 |
|
呼び出し元に、必要なアクセス許可がありません。 |
|
割り当てられていないドライブであるなど、指定されたパスが無効です。 |
|
access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティング システムで許可されません。 |
|
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。 |
解説
.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。
path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。
注意
path は、ディスクに格納されているファイルである必要はありません。ストリーム経由でアクセスできるシステム上の任意の個所を指定できます。たとえば、システムによっては、このクラスで物理デバイスにアクセスできることもあります。
CanSeek は、ファイルをカプセル化するすべての FileStream オブジェクトで true です。path がシークをサポートしないデバイスを示している場合、結果として得られる FileStream の CanSeek プロパティは false です。詳細については、CanSeek のトピックを参照してください。
ヒント
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。
その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
実行するタスク |
参考例があるトピック |
|---|---|
テキスト ファイルを作成する。 |
|
テキスト ファイルに書き込む。 |
|
テキスト ファイルから読み取る。 |
|
テキストをファイルに追加する。 |
|
ファイルの名前を変更、またはファイルを移動する。 |
|
ファイルを削除する。 |
|
ファイルをコピーする。 |
|
ファイルのサイズを取得する。 |
|
ファイルの属性を取得する。 |
|
ファイルの属性を設定する。 |
|
ファイルが存在するかどうかを判別する。 |
|
バイナリ ファイルから読み取る。 |
|
バイナリ ファイルに書き込む。 |
|
ファイルの拡張子を取得する。 |
|
ファイルの絶対パスを取得する。 |
|
パスからファイル名と拡張子を取得する。 |
|
ファイルの拡張子を変更する。 |
.NET Framework のセキュリティ
- FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。
プラットフォーム
Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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
参照
関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間