FileStreamとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

FileStream クラス

同期および非同期の読み取り操作と書き込み操作をサポートするファイル用の Stream を公開します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class FileStream
    Inherits Stream

Visual Basic (使用法)

Dim instance As FileStream

[ComVisibleAttribute(true)] 
public class FileStream : Stream

C++

[ComVisibleAttribute(true)] 
public ref class FileStream : public
 Stream

/** @attribute ComVisibleAttribute(true) */ 
public class FileStream extends Stream

JScript

ComVisibleAttribute(true) 
public class FileStream extends
 Stream

解説

FileStream クラスは、ファイルシステム上のファイルの読み取り、書き込み、オープン、クローズ、およびファイル関連のその他のオペレーティングシステムハンドル (パイプ、標準入力、標準出力など) の操作に使用します。読み取り操作と書き込み操作は、同期または非同期のどちらかに指定できます。FileStream バッファの入出力を使用するとパフォーマンスが向上します。

FileStream オブジェクトは、Seek メソッドによるファイルへのランダムアクセスをサポートします。Seek メソッドを使用すると、ファイル内の任意の位置に読み取り/書き込み位置を移動できます。これはバイトオフセット参照ポイントのパラメータで行います。バイトオフセットはシーク参照ポイントに対して相対的です。シーク参照ポイントを SeekOrigin クラスの 3 つのプロパティの指定に従って、基になるファイルの先頭、現在位置、または末尾のいずれかに指定できます。

メモ
ディスクファイルは、常にランダムアクセスをサポートします。構築時に、基になるファイルの種類に応じて、CanSeek プロパティが true または false に設定されます。具体的には、基になるファイルの種類が winbase.h で定義される FILE_TYPE_DISK の場合、CanSeek プロパティは true に設定されます。それ以外の場合、CanSeek プロパティは false に設定されます。

メモ

ディスクファイルは、常にランダムアクセスをサポートします。構築時に、基になるファイルの種類に応じて、CanSeek プロパティが true または false に設定されます。具体的には、基になるファイルの種類が winbase.h で定義される FILE_TYPE_DISK の場合、CanSeek プロパティは true に設定されます。それ以外の場合、CanSeek プロパティは false に設定されます。

同期メソッドの Read と Write、および非同期メソッドの BeginRead、BeginWrite、EndRead、EndWrite は、同期モードまたは非同期モードのどちらでも動作できますが、モードはこれらのメソッドのパフォーマンスに影響します。FileStream は、既定ではファイルを同期的に開きますが、ファイルを非同期的に開く FileStream(String,FileMode,FileAccess,FileShare,Int32,Boolean) コンストラクタも用意されています。

ファイルの一部がロックされた状態でプロセスが終了した場合、またはロックが保留されているファイルを閉じた場合の動作は未定義です。

特にディスク容量が制限された環境では、すべての FileStream オブジェクトに対して、Dispose メソッドを必ず呼び出します。使用できるディスク容量がなく、FileStream を終了する前に Dispose メソッドが呼び出されていない場合、IO 操作を実行すると例外が発生する可能性があります。

ディレクトリとその他のファイル操作については、File、Directory、Path の各クラスのトピックを参照してください。File クラスは、ファイルパス、標準入力、標準出力、および標準エラーデバイスに基づいた FileStream オブジェクトの作成を主とする静的メソッドを持つユーティリティクラスです。MemoryStream クラスは、FileStream と同様に、バイト配列と関数からストリームを作成します。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

ストリームの位置の変更の検出

FileStream オブジェクトがハンドルを排他的に保持していない場合、別のスレッドが同時にファイルハンドルにアクセスし、ファイルハンドルに関連付けられたオペレーティングシステムのファイルポインタの位置を変更する可能性があります。この場合、FileStream オブジェクト内にキャッシュされた位置とバッファ内にキャッシュされたデータが侵害される可能性があります。FileStream オブジェクトは、キャッシュされたバッファにアクセスするメソッドを定期的にチェックして、オペレーティングシステムのハンドル位置が FileStream オブジェクトで使用されるキャッシュされた位置と同じであることを保証します。

Read メソッドの呼び出し時に、ハンドル位置の予期しない変更が検出された場合、.NET Framework はバッファの内容を破棄し、ファイルからストリームを再度読み取ります。ファイルのサイズや、ファイルストリームの位置に影響を及ぼす可能性のある他のプロセスによっては、これはパフォーマンスに影響する場合があります。

Write メソッドの呼び出し時に、ハンドル位置の予期しない変更が検出された場合には、バッファの内容が破棄され、IOException がスローされます。

SafeFileHandle プロパティを使用してハンドルを公開した場合、またはコンストラクタで FileStream オブジェクトに SafeFileHandle プロパティが指定された場合に、FileStream オブジェクトはハンドルを排他的に保持しなくなります。

使用例

FileStream コンストラクタのいくつかを使用する例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String
 = "c:\temp\MyTest.txt"

        ' Delete the file if it exists.
        If File.Exists(path) Then
            File.Delete(path)
        End If

        'Create the file.
        Dim fs As FileStream = File.Create(path)

        AddText(fs, "This is some text")
        AddText(fs, "This is some more text,")
        AddText(fs, Environment.NewLine & "and this is on
 a new line")
        AddText(fs, Environment.NewLine & Environment.NewLine)
        AddText(fs, "The following is a subset of characters:"
 & Environment.NewLine)

        Dim i As Integer

        For i = 1 To 120
            AddText(fs, Convert.ToChar(i).ToString())

            'Split the output at every 10th character.
            If Math.IEEERemainder(Convert.ToDouble(i), 10) = 0
 Then
                AddText(fs, Environment.NewLine)
            End If
        Next

        fs.Close()

        'Open the stream and read it back.
        fs = File.OpenRead(path)
        Dim b(1024) As Byte
        Dim temp As UTF8Encoding = New
 UTF8Encoding(True)

        Do While fs.Read(b, 0, b.Length) >
 0
            Console.WriteLine(temp.GetString(b))
        Loop

        fs.Close()
    End Sub

    Private Shared Sub AddText(ByVal
 fs As FileStream, ByVal value As
 String)
        Dim info As Byte()
 = New UTF8Encoding(True).GetBytes(value)
        fs.Write(info, 0, info.Length)
    End Sub
End Class

using System;
using System.IO;
using System.Text;

class Test 
{
    
    public static void Main()
 
    {
        string path = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(path)) 
        {
            File.Delete(path);
        }

        //Create the file.
        using (FileStream fs = File.Create(path)) 
        {
            AddText(fs, "This is some text");
            AddText(fs, "This is some more text,");
            AddText(fs, "\r\nand this is on a new
 line");
            AddText(fs, "\r\n\r\nThe following is a subset of characters:\r\n");

            for (int i=1;i < 120;i++) 
            {
                AddText(fs, Convert.ToChar(i).ToString());

                //Split the output at every 10th character.
                if (Math.IEEERemainder(Convert.ToDouble(i), 10)
 == 0) 
                {
                    AddText(fs, "\r\n");
                }
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path)) 
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0) 
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }

    private static void
 AddText(FileStream fs, string value) 
    {
        byte[] info = new UTF8Encoding(true).GetBytes(value);
        fs.Write(info, 0, info.Length);
    }
}

C++

using namespace System;
using namespace System::IO;
using namespace System::Text;

void AddText( FileStream^ fs, String^ value )
{
   array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes(
 value );
   fs->Write( info, 0, info->Length );
}

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }

   //Create the file.
   {
      FileStream^ fs = File::Create( path );
      try
      {
         AddText( fs, "This is some text" );
         AddText( fs, "This is some more text," );
         AddText( fs, "\r\nand this is on a new
 line" );
         AddText( fs, "\r\n\r\nThe following is a subset of characters:\r\n"
 );
         for ( int i = 1; i < 120; i++ )
         {
            AddText( fs, Convert::ToChar( i ).ToString() );
            
            //Split the output at every 10th character.
            if ( Math::IEEERemainder( Convert::ToDouble( i ),
 10 ) == 0 )
            {
               AddText( fs, "\r\n" );
            }
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
   
   //Open the stream and read it back.
   {
      FileStream^ fs = File::OpenRead( path );
      try
      {
         array<Byte>^b = gcnew array<Byte>(1024);
         UTF8Encoding^ temp = gcnew UTF8Encoding( true );
         while ( fs->Read( b, 0, b->Length ) > 0 )
         {
            Console::WriteLine( temp->GetString( b ) );
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
}

import System.*;
import System.IO.*;
import System.Text.*;

class Test
{
    public static void main(String[]
 args)
    {
        String path = "c:\\temp\\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(path)) {
            File.Delete(path);
        }
        
        //Create the file.
        {
            FileStream fs = File.Create(path);
            try {
                AddText(fs, "This is some text");
                AddText(fs, "This is some more text,");
                AddText(fs, "\r\nand this is on a new
 line");
                AddText(fs, 
                    "\r\n\r\nThe following is a subset of characters:\r\n");
                for (int i = 1; i < 120;
 i++) {
                    AddText(fs, System.Convert.ToString((char)i));

                    //Split the output at every 10th character.
                    if (Math.IEEEremainder(Convert.ToDouble(i),
 10) == 0) {
                        AddText(fs, "\r\n");
                    }
                }
            }
            finally {
                fs.Dispose();
            }
        }
        //Open the stream and read it back.
        {
            FileStream fs = File.OpenRead(path);
            try {
                ubyte b[] = new ubyte[1024];
                UTF8Encoding temp = new UTF8Encoding(true);
                while (fs.Read(b, 0, b.length) > 0) {
                    Console.WriteLine(temp.GetString(b));
                }
            }
            finally {
                fs.Dispose();
            }
        }
    } //main

    private static void
 AddText(FileStream fs, String value)
    {
        ubyte info[] = (new UTF8Encoding(true)).GetBytes(value);
        fs.Write(info, 0, info.length);
    } //AddText
} //Test

ファイルを開くか、ファイルが存在しない場合はファイルを作成して、そのファイルの末尾に情報を追加する例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Text

Class FSOpenWrite

    Public Shared Sub Main()
        Dim fs As New FileStream("c:\Variables.txt",
 FileMode.Append, FileAccess.Write, FileShare.Write)
        fs.Close()
        Dim sw As New StreamWriter("c:\Variables.txt",
 True, Encoding.ASCII)
        Dim NextLine As String
 = "This is the appended text."
        sw.Write(NextLine)
        sw.Close()
    End Sub 'Main
End Class 'FSOpenWrite

using System;
using System.IO;
using System.Text;

class FSOpenWrite
{
    public static void Main()
    {
        FileStream fs=new FileStream("c:\\Variables.txt",
 FileMode.Append, FileAccess.Write, FileShare.Write);
        fs.Close();
        StreamWriter sw=new StreamWriter("c:\\Variables.txt",
 true, Encoding.ASCII);
        string NextLine="This is the appended line.";
        sw.Write(NextLine);
        sw.Close();
    }
}

C++

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   FileStream^ fs = gcnew FileStream( "c:\\Variables.txt",FileMode::Append,FileAccess::Write,FileShare::Write
 );
   fs->Close();
   StreamWriter^ sw = gcnew StreamWriter( "c:\\Variables.txt",true,Encoding::ASCII
 );
   String^ NextLine = "This is the appended line.";
   sw->Write( NextLine );
   sw->Close();
}

継承階層

System.Object
   System.MarshalByRefObject
     System.IO.Stream
      System.IO.FileStream
         System.IO.IsolatedStorage.IsolatedStorageFileStream

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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

参照

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

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32, Boolean)

メモ : このコンストラクタは、互換性のために残されています。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、FileStream インスタンスの所有権、バッファサイズ、および同期状態または非同期状態を使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

<ObsoleteAttribute("This constructor has been deprecated. 
 Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize,
 bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Sub New ( _
    handle As IntPtr, _
    access As FileAccess, _
    ownsHandle As Boolean, _
    bufferSize As Integer, _
    isAsync As Boolean _
)

Visual Basic (使用法)

Dim handle As IntPtr
Dim access As FileAccess
Dim ownsHandle As Boolean
Dim bufferSize As Integer
Dim isAsync As Boolean

Dim instance As New FileStream(handle,
 access, ownsHandle, bufferSize, isAsync)

[ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize,
 bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public FileStream (
    IntPtr handle,
    FileAccess access,
    bool ownsHandle,
    int bufferSize,
    bool isAsync
)

C++

[ObsoleteAttribute(L"This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize,
 bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
FileStream (
    IntPtr handle, 
    FileAccess access, 
    bool ownsHandle, 
    int bufferSize, 
    bool isAsync
)

/** @attribute ObsoleteAttribute("This constructor has been deprecated.  Please
 use new FileStream(SafeFileHandle handle, FileAccess access,
 int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false
 if needed.  http://go.microsoft.com/fwlink/?linkid=14202") */ 
public FileStream (
    IntPtr handle, 
    FileAccess access, 
    boolean ownsHandle, 
    int bufferSize, 
    boolean isAsync
)

JScript

ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize,
 bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")
 
public function FileStream (
    handle : IntPtr, 
    access : FileAccess, 
    ownsHandle : boolean, 
    bufferSize : int, 
    isAsync : boolean
)

パラメータ

handle: この FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得する FileAccess 定数。

ownsHandle: FileStream のインスタンスがファイルハンドルを所有する場合は true。それ以外の場合は false。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。

isAsync: ハンドルが非同期的に開かれた場合 (重複 I/O モード用) は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentOutOfRangeException	access が FileAccess.Read 未満であるか、FileAccess.ReadWrite 以上であるか、または bufferSize が 0 以下です。
ArgumentException	ハンドルが無効です。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

FileStream オブジェクトには、ファイルへの指定したアクセス権が付与されます。ハンドルの所有権は、指定されているとおりになります。この FileStream がハンドルを所有している場合は、Close メソッドの呼び出しによって、ハンドルも閉じられます。特に、そのファイルのハンドルカウントがデクリメントされます。FileStream オブジェクトには、指定したバッファサイズが付与されます。

FileStream は、ハンドルを排他的に制御していると見なされます。FileStream がハンドルも保持しているときに、読み取り、書き込み、またはシークを実行すると、データが破損することがあります。データを保護するために、ハンドルを使用する前に Flush を呼び出し、ハンドルの使用後は Close 以外のメソッドを呼び出さないようにします。または、この FileStream コンストラクタを呼び出す前に、ハンドルに対して読み取りと書き込みを行います。

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

SecurityPermission (アンマネージコードへのアクセスに必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、アクセス権、共有アクセス許可、バッファサイズ、および追加のファイルオプションを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    rights As FileSystemRights, _
    share As FileShare, _
    bufferSize As Integer, _
    options As FileOptions _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim rights As FileSystemRights
Dim share As FileShare
Dim bufferSize As Integer
Dim options As FileOptions

Dim instance As New FileStream(path,
 mode, rights, share, bufferSize, options)

public FileStream (
    string path,
    FileMode mode,
    FileSystemRights rights,
    FileShare share,
    int bufferSize,
    FileOptions options
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileSystemRights rights, 
    FileShare share, 
    int bufferSize, 
    FileOptions options
)

public FileStream (
    String path, 
    FileMode mode, 
    FileSystemRights rights, 
    FileShare share, 
    int bufferSize, 
    FileOptions options
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    rights : FileSystemRights, 
    share : FileShare, 
    bufferSize : int, 
    options : FileOptions
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

rights: ファイルのアクセス規則および監査規則の作成時に使用するアクセス権を決定する FileSystemRights 定数。

share: プロセスによるファイルの共有方法を決定する FileShare 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。bufferSize 値には 0 から 8 を設定します。実際のバッファサイズは 8 バイトに設定されます。

options: 追加のファイルオプションを指定する FileOptions 定数。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
ArgumentOutOfRangeException	bufferSize が負の値またはゼロです。または mode、access、または share に無効な値が含まれています。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
PlatformNotSupportedException	現在のオペレーティングシステムは Windows NT 以降ではありません。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定した path、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

この FileStream コンストラクタを使用して、ファイルの作成時のアクセス権を適用します。既存のファイルに対する権限にアクセスしたり変更したりするには、GetAccessControl メソッドおよび SetAccessControl メソッドの使用を検討してください。

fileOptions パラメータを使用すると、FileStream オブジェクトの作成時に活用できる、より高度な操作を利用できます。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、アクセス権、共有アクセス許可、バッファサイズ、追加のファイルオプション、アクセス制御、および監査セキュリティを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    rights As FileSystemRights, _
    share As FileShare, _
    bufferSize As Integer, _
    options As FileOptions, _
    fileSecurity As FileSecurity _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim rights As FileSystemRights
Dim share As FileShare
Dim bufferSize As Integer
Dim options As FileOptions
Dim fileSecurity As FileSecurity

Dim instance As New FileStream(path,
 mode, rights, share, bufferSize, options, fileSecurity)

public FileStream (
    string path,
    FileMode mode,
    FileSystemRights rights,
    FileShare share,
    int bufferSize,
    FileOptions options,
    FileSecurity fileSecurity
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileSystemRights rights, 
    FileShare share, 
    int bufferSize, 
    FileOptions options, 
    FileSecurity^ fileSecurity
)

public FileStream (
    String path, 
    FileMode mode, 
    FileSystemRights rights, 
    FileShare share, 
    int bufferSize, 
    FileOptions options, 
    FileSecurity fileSecurity
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    rights : FileSystemRights, 
    share : FileShare, 
    bufferSize : int, 
    options : FileOptions, 
    fileSecurity : FileSecurity
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

rights: ファイルのアクセス規則および監査規則の作成時に使用するアクセス権を決定する FileSystemRights 定数。

share: プロセスによるファイルの共有方法を決定する FileShare 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。bufferSize 値には 0 から 8 を設定します。実際のバッファサイズは 8 バイトに設定されます。

options: 追加のファイルオプションを指定する FileOptions 定数。

fileSecurity: ファイルのアクセス制御と監査セキュリティを決定する FileSecurity 定数。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
ArgumentOutOfRangeException	bufferSize が負の値またはゼロです。または mode、access、または share に無効な値が含まれています。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定した path、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
PlatformNotSupportedException	現在のオペレーティングシステムは Windows NT 以降ではありません。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

fileOptions パラメータを使用すると、FileStream オブジェクトの作成時に活用できる、より高度な操作を利用できます。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

FileStream オブジェクトを使用して、ファイルにデータを書き込み、次にデータを読み取る例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte()
 = Encoding.ASCII.GetBytes("Here is some data.")

            ' Specify an access control list (ACL)
            Dim fs As New
 FileSecurity()

            fs.AddAccessRule(New FileSystemAccessRule("DOMAINNAME\AccountName",
 FileSystemRights.ReadData, AccessControlType.Allow))

            ' Create a file using the FileStream class.
            Dim fWrite As New
 FileStream("test.txt", FileMode.Create, FileSystemRights.Modify,
 FileShare.None, 8, FileOptions.None, fs)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New
 FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer
 = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void
 Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Specify an access control list (ACL)
                FileSecurity fs = new FileSecurity();

                fs.AddAccessRule(new FileSystemAccessRule(@"DOMAINNAME\AccountName"
,
                                                            FileSystemRights.ReadData
,
                                                            AccessControlType.Allow));

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt",
 FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None,
 fs);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                
                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt",
 FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

C++

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;
using namespace System::Security::Principal;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Specify an access control list (ACL)
        FileSecurity^ fs = gcnew FileSecurity();

        fs->AddAccessRule(
            gcnew FileSystemAccessRule("MYDOMAIN\\MyAccount",
            FileSystemRights::Modify, AccessControlType::Allow));

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt",
            FileMode::Create, FileSystemRights::Modify,
            FileShare::None, 8, FileOptions::None, fs);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();

        // Open a file and read the number of bytes.

        FileStream^ fRead = 
            gcnew FileStream("test.txt", FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }

    catch (IdentityNotMappedException^)
    {
        Console::WriteLine("You need to use your own credentials " +
            " 'MYDOMAIN\\MyAccount'.");
    }

    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ

FileStream クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
FileStream (IntPtr, FileAccess)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可を使用して、指定したファイルハンドル用に初期化します。
FileStream (SafeFileHandle, FileAccess)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可を使用して、指定したファイルハンドル用に初期化します。
FileStream (String, FileMode)	FileStream クラスの新しいインスタンスを、指定したパスと作成モードを使用して作成します。 .NET Compact Framework によってサポートされています。
FileStream (IntPtr, FileAccess, Boolean)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可と FileStream インスタンスの所有権を使用して、指定したファイルハンドル用に初期化します。
FileStream (SafeFileHandle, FileAccess, Int32)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、およびバッファサイズを使用して、指定したファイルハンドル用に初期化します。
FileStream (String, FileMode, FileAccess)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、および読み取り/書き込みアクセス許可を使用して初期化します。 .NET Compact Framework によってサポートされています。
FileStream (IntPtr, FileAccess, Boolean, Int32)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、FileStream インスタンスの所有権、およびバッファサイズを使用して、指定したファイルハンドル用に初期化します。
FileStream (SafeFileHandle, FileAccess, Int32, Boolean)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、バッファサイズ、および同期状態または非同期状態を使用して、指定したファイルハンドル用に初期化します。
FileStream (String, FileMode, FileAccess, FileShare)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、および共有アクセス許可を使用して初期化します。 .NET Compact Framework によってサポートされています。
FileStream (IntPtr, FileAccess, Boolean, Int32, Boolean)	FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、FileStream インスタンスの所有権、バッファサイズ、および同期状態または非同期状態を使用して、指定したファイルハンドル用に初期化します。
FileStream (String, FileMode, FileAccess, FileShare, Int32)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、およびバッファサイズを使用して初期化します。 .NET Compact Framework によってサポートされています。
FileStream (String, FileMode, FileAccess, FileShare, Int32, Boolean)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、バッファサイズ、および同期状態または非同期状態を使用して初期化します。 .NET Compact Framework によってサポートされています。
FileStream (String, FileMode, FileAccess, FileShare, Int32, FileOptions)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、同一のファイルに対して他の FileStream が保有できるアクセス、バッファサイズ、および追加のファイルオプションを使用して初期化します。
FileStream (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、アクセス権、共有アクセス許可、バッファサイズ、および追加のファイルオプションを使用して初期化します。
FileStream (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)	FileStream クラスの新しいインスタンスを、指定したパス、作成モード、アクセス権、共有アクセス許可、バッファサイズ、追加のファイルオプション、アクセス制御、および監査セキュリティを使用して初期化します。

参照

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32, Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、バッファサイズ、および同期状態または非同期状態を使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    handle As SafeFileHandle, _
    access As FileAccess, _
    bufferSize As Integer, _
    isAsync As Boolean _
)

Visual Basic (使用法)

Dim handle As SafeFileHandle
Dim access As FileAccess
Dim bufferSize As Integer
Dim isAsync As Boolean

Dim instance As New FileStream(handle,
 access, bufferSize, isAsync)

public FileStream (
    SafeFileHandle handle,
    FileAccess access,
    int bufferSize,
    bool isAsync
)

C++

public:
FileStream (
    SafeFileHandle^ handle, 
    FileAccess access, 
    int bufferSize, 
    bool isAsync
)

public FileStream (
    SafeFileHandle handle, 
    FileAccess access, 
    int bufferSize, 
    boolean isAsync
)

JScript

public function FileStream (
    handle : SafeFileHandle, 
    access : FileAccess, 
    bufferSize : int, 
    isAsync : boolean
)

パラメータ

handle: この FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得する FileAccess 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。

isAsync: ハンドルが非同期的に開かれた場合 (重複 I/O モード用) は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentException	handle パラメータが無効なハンドルです。または handle パラメータが同期ハンドルであるのに、非同期的に使用されました。
ArgumentOutOfRangeException	bufferSize パラメータが負の値です。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。
SecurityPermission (アンマネージコードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ (String, FileMode, FileAccess)

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、および読み取り/書き込みアクセス許可を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim access As FileAccess

Dim instance As New FileStream(path,
 mode, access)

public FileStream (
    string path,
    FileMode mode,
    FileAccess access
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileAccess access
)

public FileStream (
    String path, 
    FileMode mode, 
    FileAccess access
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    access : FileAccess
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

access: FileStream オブジェクトがファイルにアクセスする方法を決定する FileAccess 定数。これは、FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得します。path にディスクファイルが指定されている場合、CanSeek は true になります。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
ArgumentOutOfRangeException	mode に無効な値が含まれています。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

コンストラクタにはファイルへの読み取り/書き込みアクセス権が付与されます。ファイルは共有読み取りモードで開きます。そのため、FileStream オブジェクトが閉じられるまで、この処理または別の処理でファイルを書き込み用に開く要求は失敗しますが、読み取り要求は成功します。バッファサイズは、既定のサイズである 8192 バイト (8 KB) に設定されます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

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

参照

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32)

メモ : このコンストラクタは、互換性のために残されています。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、FileStream インスタンスの所有権、およびバッファサイズを使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

<ObsoleteAttribute("This constructor has been deprecated. 
 Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize)
 instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")> _
Public Sub New ( _
    handle As IntPtr, _
    access As FileAccess, _
    ownsHandle As Boolean, _
    bufferSize As Integer _
)

Visual Basic (使用法)

Dim handle As IntPtr
Dim access As FileAccess
Dim ownsHandle As Boolean
Dim bufferSize As Integer

Dim instance As New FileStream(handle,
 access, ownsHandle, bufferSize)

[ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize)
 instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public FileStream (
    IntPtr handle,
    FileAccess access,
    bool ownsHandle,
    int bufferSize
)

C++

[ObsoleteAttribute(L"This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize)
 instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
FileStream (
    IntPtr handle, 
    FileAccess access, 
    bool ownsHandle, 
    int bufferSize
)

/** @attribute ObsoleteAttribute("This constructor has been deprecated.  Please
 use new FileStream(SafeFileHandle handle, FileAccess access,
 int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if
 needed.  http://go.microsoft.com/fwlink/?linkid=14202") */ 
public FileStream (
    IntPtr handle, 
    FileAccess access, 
    boolean ownsHandle, 
    int bufferSize
)

JScript

ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access, int bufferSize)
 instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")
 
public function FileStream (
    handle : IntPtr, 
    access : FileAccess, 
    ownsHandle : boolean, 
    bufferSize : int
)

パラメータ

handle: この FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得する FileAccess 定数。

ownsHandle: FileStream のインスタンスがファイルハンドルを所有する場合は true。それ以外の場合は false。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。

例外

例外の種類	条件
ArgumentOutOfRangeException	bufferSize が負の値です。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

FileStream コンストラクタ (IntPtr, FileAccess, Boolean)

メモ : このコンストラクタは、互換性のために残されています。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可と FileStream インスタンスの所有権を使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

<ObsoleteAttribute("This constructor has been deprecated. 
 Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and
 optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")> _
Public Sub New ( _
    handle As IntPtr, _
    access As FileAccess, _
    ownsHandle As Boolean _
)

Visual Basic (使用法)

Dim handle As IntPtr
Dim access As FileAccess
Dim ownsHandle As Boolean

Dim instance As New FileStream(handle,
 access, ownsHandle)

[ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make
 a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public FileStream (
    IntPtr handle,
    FileAccess access,
    bool ownsHandle
)

C++

[ObsoleteAttribute(L"This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make
 a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
FileStream (
    IntPtr handle, 
    FileAccess access, 
    bool ownsHandle
)

/** @attribute ObsoleteAttribute("This constructor has been deprecated.  Please
 use new FileStream(SafeFileHandle handle, FileAccess access)
 instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")
 */ 
public FileStream (
    IntPtr handle, 
    FileAccess access, 
    boolean ownsHandle
)

JScript

ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make
 a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")
 
public function FileStream (
    handle : IntPtr, 
    access : FileAccess, 
    ownsHandle : boolean
)

パラメータ

handle: 現在の FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得する FileAccess 定数。

ownsHandle: FileStream のインスタンスがファイルハンドルを所有する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentException	access が FileAccess のフィールドではありません。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

FileStream オブジェクトには、ファイルへの指定したアクセス権が付与されます。ハンドルの所有権は、指定されているとおりになります。このプロセスがハンドルを所有している場合は、Close メソッドの呼び出しによって、ハンドルも閉じられ、ファイルのハンドルカウントがデクリメントされます。FileStream オブジェクトには、8,192 バイトの既定のバッファサイズが付与されます。

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可、およびバッファサイズを使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    handle As SafeFileHandle, _
    access As FileAccess, _
    bufferSize As Integer _
)

Visual Basic (使用法)

Dim handle As SafeFileHandle
Dim access As FileAccess
Dim bufferSize As Integer

Dim instance As New FileStream(handle,
 access, bufferSize)

public FileStream (
    SafeFileHandle handle,
    FileAccess access,
    int bufferSize
)

C++

public:
FileStream (
    SafeFileHandle^ handle, 
    FileAccess access, 
    int bufferSize
)

public FileStream (
    SafeFileHandle handle, 
    FileAccess access, 
    int bufferSize
)

JScript

public function FileStream (
    handle : SafeFileHandle, 
    access : FileAccess, 
    bufferSize : int
)

パラメータ

handle: 現在の FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得する FileAccess 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。

例外

例外の種類	条件
ArgumentException	handle パラメータが無効なハンドルです。または handle パラメータが同期ハンドルであるのに、非同期的に使用されました。
ArgumentOutOfRangeException	bufferSize パラメータが負の値です。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。
SecurityPermission (アンマネージコードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ (String, FileMode)

FileStream クラスの新しいインスタンスを、指定したパスと作成モードを使用して作成します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode

Dim instance As New FileStream(path,
 mode)

public FileStream (
    string path,
    FileMode mode
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode
)

public FileStream (
    String path, 
    FileMode mode
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

例外

例外の種類	条件
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはストリームは閉じられています。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
ArgumentOutOfRangeException	mode に無効な値が含まれています。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

コンストラクタにはファイルへの読み取り/書き込みアクセス権が付与されます。ファイルは共有読み取りモードで開きます。そのため、FileStream オブジェクトが閉じられるまで、この処理または別の処理でファイルを書き込み用に開く要求は失敗しますが、読み取り要求は成功します。バッファサイズは、既定のサイズである 4096 バイト (4 KB) に設定されます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

ファイルにデータをバイト単位で書き込み、さらにデータが正常に書き込まれたことを確認する例を次に示します。

Visual Basic

Imports Microsoft.VisualBasic
Imports System
Imports System.IO
Imports System.Text

Class FStream

    Shared Sub Main()

        Const fileName As String
 = "Test#@@#.dat"

        ' Create random data to write to the file.
        Dim dataArray(100000) As Byte
        Dim randomGenerator As New
 Random()
        randomGenerator.NextBytes(dataArray)

        Dim fileStream As FileStream = _
            new FileStream(fileName, FileMode.Create)
        Try

            ' Write the data to the file, byte by byte.
            For i As Integer
 = 0 To dataArray.Length - 1
                fileStream.WriteByte(dataArray(i))
            Next i

            ' Set the stream position to the beginning of the stream.
            fileStream.Seek(0, SeekOrigin.Begin)

            ' Read and verify the data.
            For i As Integer
 = 0 To _
                CType(fileStream.Length, Integer) - 1

                If dataArray(i) <> fileStream.ReadByte()
 Then
                    Console.WriteLine("Error writing data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written to {0} "
 & _
                "and verified.", fileStream.Name)
        Finally
            fileStream.Close()
        End Try
    
    End Sub
End Class

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream  
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length;
 i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length;
 i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}

C++

using namespace System;
using namespace System::IO;
int main()
{
   String^ fileName =  "Test@##@.dat";
   
   // Create random data to write to the file.
   array<Byte>^dataArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( dataArray );
   FileStream^ fileStream = gcnew FileStream( fileName,FileMode::Create );
   try
   {
      
      // Write the data to the file, byte by byte.
      for ( int i = 0; i < dataArray->Length;
 i++ )
      {
         fileStream->WriteByte( dataArray[ i ] );

      }
      
      // Set the stream position to the beginning of the file.
      fileStream->Seek( 0, SeekOrigin::Begin );
      
      // Read and verify the data.
      for ( int i = 0; i < fileStream->Length;
 i++ )
      {
         if ( dataArray[ i ] != fileStream->ReadByte() )
         {
            Console::WriteLine( "Error writing data." );
            return  -1;
         }

      }
      Console::WriteLine( "The data was written to {0} "
      "and verified.", fileStream->Name );
   }
   finally
   {
      fileStream->Close();
   }

}

import System.*;
import System.IO.*;

class FStream
{   
    public static void main(String[]
 args)
    {
        final String fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        ubyte dataArray[] = new ubyte[100000];
        new Random().NextBytes(dataArray);        

        FileStream fileStream = new FileStream(fileName, FileMode.Create);
        try {
            // Write the data to the file, byte by byte.
            for(int i=0;i < dataArray.length;i++)
 {
                fileStream.WriteByte(dataArray[i]);
            } 

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i=0;i < fileStream.get_Length();i++)
 {
                if ( dataArray[i] != fileStream.ReadByte()  )
 {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            } 
            Console.WriteLine("The data was written to {0} "
                + "and verified.", fileStream.get_Name());
        }
        finally {
            fileStream.Dispose();
        }        
    } //main
} //FStream

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

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

参照

関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間
InvalidPathChars
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare)

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、および共有アクセス許可を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess, _
    share As FileShare _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim access As FileAccess
Dim share As FileShare

Dim instance As New FileStream(path,
 mode, access, share)

public FileStream (
    string path,
    FileMode mode,
    FileAccess access,
    FileShare share
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share
)

public FileStream (
    String path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    access : FileAccess, 
    share : FileShare
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

access: FileStream オブジェクトがファイルにアクセスする方法を決定する FileAccess 定数。これは、FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得します。path にディスクファイルが指定されている場合、CanSeek は true になります。

share: プロセスによるファイルの共有方法を決定する FileShare 定数。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはシステムで Windows 98 または Windows 98 Second Edition を実行しており、share が FileShare.Delete に設定されています。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
ArgumentOutOfRangeException	mode に無効な値が含まれています。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

次のコード例は Lock メソッドの例の一部です。

Visual Basic

Dim aFileStream As New FileStream(
 _
    "Test#@@#.dat", FileMode.OpenOrCreate, _
    FileAccess.ReadWrite, FileShare.ReadWrite)

using(FileStream fileStream = new FileStream(
    "Test#@@#.dat", FileMode.OpenOrCreate, 
    FileAccess.ReadWrite, FileShare.ReadWrite))

C++

FileStream^ fileStream = gcnew FileStream( "Test#@@#.dat",FileMode::OpenOrCreate,FileAccess::ReadWrite,FileShare::ReadWrite
 );

FileStream fileStream =  new FileStream
    ("Test#@@#.dat", FileMode.OpenOrCreate, FileAccess.ReadWrite,
    FileShare.ReadWrite);

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

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

参照

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, Boolean)

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、バッファサイズ、および同期状態または非同期状態を使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess, _
    share As FileShare, _
    bufferSize As Integer, _
    useAsync As Boolean _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim access As FileAccess
Dim share As FileShare
Dim bufferSize As Integer
Dim useAsync As Boolean

Dim instance As New FileStream(path,
 mode, access, share, bufferSize, useAsync)

public FileStream (
    string path,
    FileMode mode,
    FileAccess access,
    FileShare share,
    int bufferSize,
    bool useAsync
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize, 
    bool useAsync
)

public FileStream (
    String path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize, 
    boolean useAsync
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    access : FileAccess, 
    share : FileShare, 
    bufferSize : int, 
    useAsync : boolean
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

access: FileStream オブジェクトがファイルにアクセスする方法を決定する FileAccess 定数。これは、FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得します。path にディスクファイルが指定されている場合、CanSeek は true になります。

share: プロセスによるファイルの共有方法を決定する FileShare 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。bufferSize 値には 0 から 8 を設定します。実際のバッファサイズは 8 バイトに設定されます。

useAsync: 非同期 I/O または同期 I/O のどちらを使用するかを指定します。ただし、基になるオペレーティングシステムが非同期 I/O をサポートしていないことがあります。したがって、true を指定しても、プラットフォームによってはハンドルが同期的に開かれることがあります。非同期的に開いた場合、BeginRead メソッドと BeginWrite メソッドは、大量の読み取りまたは書き込み時にはパフォーマンスがより高くなりますが、少量の読み取りまたは書き込み時にはパフォーマンスが非常に低くなることがあります。アプリケーションが非同期 I/O を利用するように設計されている場合は、useAsync パラメータを true に設定します。非同期 I/O を正しく使用すると、アプリケーションが 10 倍ほど高速化することがあります。ただし、非同期 I/O 用にアプリケーションを再設計せずに非同期 I/O を使用すると、パフォーマンスが 10 分の 1 ほど低下することがあります。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
ArgumentOutOfRangeException	bufferSize が負の値またはゼロです。または mode、access、または share に無効な値が含まれています。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはシステムで Windows 98 または Windows 98 Second Edition を実行しており、share が FileShare.Delete に設定されています。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

ファイルにデータを非同期的に書き込み、さらにデータが正常に書き込まれたことを確認する例を次に示します。EndReadCallback メソッドと EndWriteCallback メソッドにメインスレッドの情報を渡すために、State オブジェクトが作成されます。

Visual Basic

Imports System
Imports System.IO
Imports System.Threading

Class FStream

    Shared Sub Main()

        ' Create a synchronization object that gets 
        ' signaled when verification is complete.
        Dim manualEvent As New
 ManualResetEvent(False)

        ' Create random data to write to the file.
        Dim writeArray(100000) As Byte
        Dim randomGenerator As New
 Random()
        randomGenerator.NextBytes(writeArray)

        Dim fStream As New
 FileStream("Test#@@#.dat", _
            FileMode.Create, FileAccess.ReadWrite, _
            FileShare.None, 4096, True)

        ' Check that the FileStream was opened asynchronously.
        If fStream.IsAsync = True
            Console.WriteLine("fStream was opened asynchronously.")
        Else
            Console.WriteLine("fStream was not opened asynchronously.")
        End If

        ' Asynchronously write to the file.
        Dim asyncResult As IAsyncResult = fStream.BeginWrite(
 _
            writeArray, 0, writeArray.Length, _
            AddressOf EndWriteCallback , _
            New State(fStream, writeArray, manualEvent))

        ' Concurrently do other work and then wait
        ' for the data to be written and verified.
        manualEvent.WaitOne(5000, False)
    End Sub

    ' When BeginWrite is finished writing data to the file, the
    ' EndWriteCallback method is called to end the asynchronous 
    ' write operation and then read back and verify the data.
    Private Shared Sub EndWriteCallback(asyncResult
 As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim fStream As FileStream = tempState.FStream
        fStream.EndWrite(asyncResult)

        ' Asynchronously read back the written data.
        fStream.Position = 0
        asyncResult = fStream.BeginRead( _ 
            tempState.ReadArray, 0 , tempState.ReadArray.Length, _
            AddressOf EndReadCallback, tempState)

        ' Concurrently do other work, such as 
        ' logging the write operation.
    End Sub

    ' When BeginRead is finished reading data from the file, the 
    ' EndReadCallback method is called to end the asynchronous 
    ' read operation and then verify the data.
   Private Shared Sub EndReadCallback(asyncResult
 As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim readCount As Integer
 = _
            tempState.FStream.EndRead(asyncResult)

        Dim i As Integer
 = 0
        While(i < readCount)
            If(tempState.ReadArray(i) <> tempState.WriteArray(i))
                Console.WriteLine("Error writing data.")
                tempState.FStream.Close()
                Return
            End If
            i += 1
        End While

        Console.WriteLine("The data was written to {0} and "
 & _
            "verified.", tempState.FStream.Name)
        tempState.FStream.Close()

        ' Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set()
    End Sub

    ' Maintain state information to be passed to 
    ' EndWriteCallback and EndReadCallback.
    Private Class State

        ' fStreamValue is used to read and write to the file.
        Dim fStreamValue As FileStream

        ' writeArrayValue stores data that is written to the file.
        Dim writeArrayValue As Byte()

        ' readArrayValue stores data that is read from the file.
        Dim readArrayValue As Byte()

        ' manualEvent signals the main thread 
        ' when verification is complete.
        Dim manualEventValue As ManualResetEvent
 

        Sub New(aStream As
 FileStream, anArray As Byte(), _
            manualEvent As ManualResetEvent)

            fStreamValue     = aStream
            writeArrayValue  = anArray
            manualEventValue = manualEvent
            readArrayValue   = New Byte(anArray.Length
 - 1){}
        End Sub    

            Public ReadOnly Property
 FStream() As FileStream
                Get
                    Return fStreamValue
                End Get
            End Property

            Public ReadOnly Property
 WriteArray() As Byte()
                Get
                    Return writeArrayValue
                End Get
            End Property

            Public ReadOnly Property
 ReadArray() As Byte()
                Get
                    Return readArrayValue
                End Get
            End Property

            Public ReadOnly Property
 ManualEvent() As ManualResetEvent
                Get
                    Return manualEventValue
                End Get
            End Property
    End Class 
   
End Class

using System;
using System.IO;
using System.Threading;

class FStream
{
    static void Main()
    {
        // Create a synchronization object that gets 
        // signaled when verification is complete.
        ManualResetEvent manualEvent = new ManualResetEvent(false);

        // Create random data to write to the file.
        byte[] writeArray = new byte[100000];
        new Random().NextBytes(writeArray);

        FileStream fStream = 
            new FileStream("Test#@@#.dat", FileMode.Create,
 
            FileAccess.ReadWrite, FileShare.None, 4096, true);

        // Check that the FileStream was opened asynchronously.
        Console.WriteLine("fStream was {0}opened asynchronously.",
            fStream.IsAsync ? "" : "not ");

        // Asynchronously write to the file.
        IAsyncResult asyncResult = fStream.BeginWrite(
            writeArray, 0, writeArray.Length, 
            new AsyncCallback(EndWriteCallback), 
            new State(fStream, writeArray, manualEvent));

        // Concurrently do other work and then wait 
        // for the data to be written and verified.
        manualEvent.WaitOne(5000, false);
    }

    // When BeginWrite is finished writing data to the file, the
    // EndWriteCallback method is called to end the asynchronous 
    // write operation and then read back and verify the data.
    static void EndWriteCallback(IAsyncResult
 asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        FileStream fStream = tempState.FStream;
        fStream.EndWrite(asyncResult);

        // Asynchronously read back the written data.
        fStream.Position = 0;
        asyncResult = fStream.BeginRead(
            tempState.ReadArray, 0 , tempState.ReadArray.Length, 
            new AsyncCallback(EndReadCallback), tempState);

        // Concurrently do other work, such as 
        // logging the write operation.
    }

    // When BeginRead is finished reading data from the file, the 
    // EndReadCallback method is called to end the asynchronous 
    // read operation and then verify the data.
    static void EndReadCallback(IAsyncResult
 asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        int readCount = tempState.FStream.EndRead(asyncResult);

        int i = 0;
        while(i < readCount)
        {
            if(tempState.ReadArray[i] != tempState.WriteArray[i++])
            {
                Console.WriteLine("Error writing data.");
                tempState.FStream.Close();
                return;
            }
        }
        Console.WriteLine("The data was written to {0} and verified.",
            tempState.FStream.Name);
        tempState.FStream.Close();

        // Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set();
    }

    // Maintain state information to be passed to 
    // EndWriteCallback and EndReadCallback.
    class State
    {
        // fStream is used to read and write to the file.
        FileStream fStream;

        // writeArray stores data that is written to the file.
        byte[] writeArray;

        // readArray stores data that is read from the file.
        byte[] readArray;

        // manualEvent signals the main thread 
        // when verification is complete.
        ManualResetEvent manualEvent;

        public State(FileStream fStream, byte[] writeArray, 
            ManualResetEvent manualEvent)
        {
            this.fStream   = fStream;
            this.writeArray = writeArray;
            this.manualEvent = manualEvent;
            readArray = new byte[writeArray.Length];
        }

        public FileStream FStream
        { get{ return fStream; } }

        public byte[] WriteArray
        { get{ return writeArray; } }

        public byte[] ReadArray
        { get{ return readArray; } }

        public ManualResetEvent ManualEvent
        { get{ return manualEvent; } }
    }
}

C++

using namespace System;
using namespace System::IO;
using namespace System::Threading;

// Maintain state information to be passed to 
// EndWriteCallback and EndReadCallback.
ref class State
{
private:

   // fStream is used to read and write to the file.
   FileStream^ fStream;

   // writeArray stores data that is written to the file.
   array<Byte>^writeArray;

   // readArray stores data that is read from the file.
   array<Byte>^readArray;

   // manualEvent signals the main thread 
   // when verification is complete.
   ManualResetEvent^ manualEvent;

public:
   State( FileStream^ fStream, array<Byte>^writeArray, ManualResetEvent^ manualEvent
 )
   {
      this->fStream = fStream;
      this->writeArray = writeArray;
      this->manualEvent = manualEvent;
      readArray = gcnew array<Byte>(writeArray->Length);
   }


   property FileStream^ FStream 
   {
      FileStream^ get()
      {
         return fStream;
      }

   }

   property array<Byte>^ WriteArray 
   {
      array<Byte>^ get()
      {
         return writeArray;
      }

   }

   property array<Byte>^ ReadArray 
   {
      array<Byte>^ get()
      {
         return readArray;
      }

   }

   property ManualResetEvent^ ManualEvent 
   {
      ManualResetEvent^ get()
      {
         return manualEvent;
      }

   }

};

ref class FStream
{
private:

   // When BeginRead is finished reading data from the file, the 
   // EndReadCallback method is called to end the asynchronous 
   // read operation and then verify the data.
   static void EndReadCallback( IAsyncResult^
 asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      int readCount = tempState->FStream->EndRead( asyncResult
 );
      int i = 0;
      while ( i < readCount )
      {
         if ( tempState->ReadArray[ i ] != tempState->WriteArray[
 i++ ] )
         {
            Console::WriteLine( "Error writing data." );
            tempState->FStream->Close();
            return;
         }
      }

      Console::WriteLine( "The data was written to {0} "
      "and verified.", tempState->FStream->Name );
      tempState->FStream->Close();
      
      // Signal the main thread that the verification is finished.
      tempState->ManualEvent->Set();
   }


public:

   // When BeginWrite is finished writing data to the file, the
   // EndWriteCallback method is called to end the asynchronous 
   // write operation and then read back and verify the data.
   static void EndWriteCallback( IAsyncResult^
 asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      FileStream^ fStream = tempState->FStream;
      fStream->EndWrite( asyncResult );
      
      // Asynchronously read back the written data.
      fStream->Position = 0;
      asyncResult = fStream->BeginRead( tempState->ReadArray, 0, tempState->ReadArray->Length,
 gcnew AsyncCallback( &FStream::EndReadCallback ), tempState );
      
      // Concurrently do other work, such as 
      // logging the write operation.
   }

};


int main()
{
   
   // Create a synchronization object that gets 
   // signaled when verification is complete.
   ManualResetEvent^ manualEvent = gcnew ManualResetEvent( false
 );
   
   // Create the data to write to the file.
   array<Byte>^writeArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( writeArray );
   FileStream^ fStream = gcnew FileStream(  "Test#@@#.dat",FileMode::Create,FileAccess::ReadWrite,FileShare::None,4096,true
 );
   
   // Check that the FileStream was opened asynchronously.
   Console::WriteLine( "fStream was {0}opened asynchronously.", fStream->IsAsync
 ? (String^)"" : "not " );
   
   // Asynchronously write to the file.
   IAsyncResult^ asyncResult = fStream->BeginWrite( writeArray, 0, writeArray->Length,
 gcnew AsyncCallback( &FStream::EndWriteCallback ), gcnew State( fStream,writeArray,manualEvent
 ) );
   
   // Concurrently do other work and then wait 
   // for the data to be written and verified.
   manualEvent->WaitOne( 5000, false );
}

import System.*;
import System.IO.*;
import System.Threading.*;

class FStream
{   
    public static void main(String[]
 args)
    {
        // Create a synchronization object that gets 
        // signaled when verification is complete.
        ManualResetEvent manualEvent = new ManualResetEvent(false);

        // Create random data to write to the file.
        ubyte writeArray[] = new ubyte[100000];
        new Random().NextBytes(writeArray);

        FileStream fStream =  new FileStream("Test#@@#.dat",
 FileMode.Create,
            FileAccess.ReadWrite, FileShare.None, 4096, true);

        // Check that the FileStream was opened asynchronously.
        Console.WriteLine("fStream was {0}opened asynchronously.",
            (fStream.get_IsAsync()) ? "" : "not ");
        FStream classfStream = new FStream();

        // Asynchronously write to the file.
        IAsyncResult asyncResult = fStream.BeginWrite(writeArray, 0,
            writeArray.length, new AsyncCallback(EndWriteCallback)
,
            classfStream.new State(fStream, writeArray, manualEvent));

        // Concurrently do other work and then wait 
        // for the data to be written and verified.
        manualEvent.WaitOne(5000, false);
    } //main

    // When BeginWrite is finished writing data to the file, the
    // EndWriteCallback method is called to end the asynchronous 
    // write operation and then read back and verify the data.
    static void EndWriteCallback(IAsyncResult
 asyncResult)
    {
        State tempState = ((State)(asyncResult.get_AsyncState()));
        FileStream fStream = tempState.get_FStream();
        fStream.EndWrite(asyncResult);

        // Asynchronously read back the written data.
        fStream.set_Position(0);
        asyncResult = fStream.BeginRead(tempState.get_ReadArray(), 0,
            tempState.get_ReadArray().length , 
            new AsyncCallback(EndReadCallback), tempState);

        // Concurrently do other work, such as 
        // logging the write operation.
    } //EndWriteCallback

    // When BeginRead is finished reading data from the file, the 
    // EndReadCallback method is called to end the asynchronous 
    // read operation and then verify the data.
    static void EndReadCallback(IAsyncResult
 asyncResult)
    {
        State tempState = ((State)(asyncResult.get_AsyncState()));
        int readCount = tempState.get_FStream().EndRead(asyncResult);
        int i = 0;
        while((i < readCount)) {
            if ( tempState.get_ReadArray()[i] != 
                    tempState.get_WriteArray()[i++] ) {
                Console.WriteLine("Error writing data.");
                tempState.get_FStream().Close();
                return;
            }
        }
        Console.WriteLine("The data was written to {0} and verified.",
            tempState.get_FStream().get_Name());
        tempState.get_FStream().Close();

        // Signal the main thread that the verification is finished.
        tempState.get_ManualEvent().Set();
    } //EndReadCallback

    // Maintain state information to be passed to 
    // EndWriteCallback and EndReadCallback.
    class State
    {
        // fStream is used to read and write to the file.
        private FileStream fStream;

        // writeArray stores data that is written to the file.
        private ubyte writeArray[];

        // readArray stores data that is read from the file.
        private ubyte readArray[];

        // manualEvent signals the main thread 
        // when verification is complete.
        private ManualResetEvent manualEvent;

        public State(FileStream fStream, ubyte writeArray[],
                    ManualResetEvent manualEvent)
        {
            this.fStream = fStream;
            this.writeArray = writeArray;
            this.manualEvent = manualEvent;
            readArray = new ubyte[writeArray.length ];
        } //State
      
        /** @property 
         */
        public FileStream get_FStream()
        {
            return fStream ;
        }//get_FStream

        /** @property 
         */
        public ubyte[] get_WriteArray()
        {
            return writeArray ;
        }//get_WriteArray

        /** @property 
         */
        public ubyte[] get_ReadArray()
        {
            return readArray;
        }//get_ReadArray

        /** @property 
         */
        public ManualResetEvent get_ManualEvent()
        {
            return manualEvent;
        }//get_ManualEvent
    } //State
} //FStream

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

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

参照

関連項目
FileStream クラス
FileStream メンバ
System.IO 名前空間
File クラス
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileStream コンストラクタ (SafeFileHandle, FileAccess)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可を使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    handle As SafeFileHandle, _
    access As FileAccess _
)

Visual Basic (使用法)

Dim handle As SafeFileHandle
Dim access As FileAccess

Dim instance As New FileStream(handle,
 access)

public FileStream (
    SafeFileHandle handle,
    FileAccess access
)

C++

public:
FileStream (
    SafeFileHandle^ handle, 
    FileAccess access
)

public FileStream (
    SafeFileHandle handle, 
    FileAccess access
)

JScript

public function FileStream (
    handle : SafeFileHandle, 
    access : FileAccess
)

パラメータ

handle: 現在の FileStream オブジェクトによってカプセル化されるファイルのファイルハンドル。

access: FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを設定する FileAccess 定数。

例外

例外の種類	条件
ArgumentException	access が FileAccess のフィールドではありません。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

Close が呼び出されると、ハンドルも閉じられ、ファイルのハンドルカウントがデクリメントされます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, FileOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、同一のファイルに対して他の FileStream が保有できるアクセス、バッファサイズ、および追加のファイルオプションを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess, _
    share As FileShare, _
    bufferSize As Integer, _
    options As FileOptions _
)

Visual Basic (使用法)

Dim path As String
Dim mode As FileMode
Dim access As FileAccess
Dim share As FileShare
Dim bufferSize As Integer
Dim options As FileOptions

Dim instance As New FileStream(path,
 mode, access, share, bufferSize, options)

public FileStream (
    string path,
    FileMode mode,
    FileAccess access,
    FileShare share,
    int bufferSize,
    FileOptions options
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize, 
    FileOptions options
)

public FileStream (
    String path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize, 
    FileOptions options
)

JScript

public function FileStream (
    path : String, 
    mode : FileMode, 
    access : FileAccess, 
    share : FileShare, 
    bufferSize : int, 
    options : FileOptions
)

パラメータ

path: 現在の FileStream オブジェクトによってカプセル化されるファイルの相対パスまたは絶対パス。

mode: ファイルを開く方法または作成する方法を決定する FileMode 定数。

access: FileStream オブジェクトがファイルにアクセスする方法を決定する FileAccess 定数。これは、FileStream オブジェクトの CanRead プロパティと CanWrite プロパティを取得します。path にディスクファイルが指定されている場合、CanSeek は true になります。

share: プロセスによるファイルの共有方法を決定する FileShare 定数。

bufferSize: バッファサイズを示す 0 より大きな正の Int32 値。bufferSize 値には 0 から 8 を設定します。実際のバッファサイズは 8 バイトに設定されます。

options: 追加のファイルオプションを指定する FileOptions 値。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
ArgumentOutOfRangeException	bufferSize が負の値またはゼロです。または mode、access、または share に無効な値が含まれています。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

fileOptions パラメータを使用すると、FileStream オブジェクトの作成時に活用できる、より高度な操作を利用できます。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

使用例

FileStream オブジェクトを使用して、ファイルにデータを書き込み、次にデータを読み取る例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte()
 = Encoding.ASCII.GetBytes("Here is some data.")

            ' Create a file using the FileStream class.
            Dim fWrite As New
 FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite,
 FileShare.None, 8, FileOptions.None)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New
 FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer
 = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void
 Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt",
 FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                
                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt",
 FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

C++

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt", FileMode::Create
,
            FileAccess::ReadWrite, FileShare::None, 8, FileOptions::None);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();


        // Open a file and read the number of bytes.

        FileStream^ fRead = gcnew FileStream("test.txt", 
            FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32)

FileStream クラスの新しいインスタンスを、指定したパス、作成モード、読み取り/書き込みアクセス許可、共有アクセス許可、およびバッファサイズを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess, _
    share As FileShare, _
    bufferSize As Integer _
)

Visual Basic (使用法)

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
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize
)

public FileStream (
    String path, 
    FileMode mode, 
    FileAccess access, 
    FileShare share, 
    int bufferSize
)

JScript

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 バイトに設定されます。

例外

例外の種類	条件
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。または path がファイル以外のデバイスを参照しています (NTFS 環境の "con:"、"com1:"、"lpt1:" など)。
NotSupportedException	path がファイル以外のデバイスを参照しています (NTFS 以外の環境の "con:"、"com1:"、"lpt1:" など)。
ArgumentException	path が空の文字列 ("") か、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。
ArgumentOutOfRangeException	bufferSize が負の値またはゼロです。または mode、access、または share に無効な値が含まれています。
FileNotFoundException	ファイルが見つかりません。たとえば、mode が FileMode.Truncate または FileMode.Open の場合に、path で指定されたファイルが存在しません。これらのモードでは、ファイルが既に存在している必要があります。
IOException	FileMode.CreateNew が指定されているのに、path で指定したファイルが既に存在していることなどが原因で I/O エラーが発生しました。またはシステムで Windows 98 または Windows 98 Second Edition を実行しており、share が FileShare.Delete に設定されています。またはストリームは閉じられています。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルまたはディレクトリが読み取り専用に設定されているなど、指定した path に対する access 要求がオペレーティングシステムで許可されません。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

path パラメータにはファイル名も指定できます。このファイルには、UNC 共有のファイルも含まれます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

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

参照

FileStream コンストラクタ (IntPtr, FileAccess)

メモ : このコンストラクタは、互換性のために残されています。

FileStream クラスの新しいインスタンスを、指定した読み取り/書き込みアクセス許可を使用して、指定したファイルハンドル用に初期化します。

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

Visual Basic (宣言)

<ObsoleteAttribute("This constructor has been deprecated. 
 Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Sub New ( _
    handle As IntPtr, _
    access As FileAccess _
)

Visual Basic (使用法)

Dim handle As IntPtr
Dim access As FileAccess

Dim instance As New FileStream(handle,
 access)

[ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public FileStream (
    IntPtr handle,
    FileAccess access
)

C++

[ObsoleteAttribute(L"This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
FileStream (
    IntPtr handle, 
    FileAccess access
)

/** @attribute ObsoleteAttribute("This constructor has been deprecated.  Please
 use new FileStream(SafeFileHandle handle, FileAccess access)
 instead.  http://go.microsoft.com/fwlink/?linkid=14202") */ 
public FileStream (
    IntPtr handle, 
    FileAccess access
)

JScript

ObsoleteAttribute("This constructor has been deprecated.  Please use new
 FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")
 
public function FileStream (
    handle : IntPtr, 
    access : FileAccess
)

パラメータ

handle

access

例外

例外の種類	条件
ArgumentException	access が FileAccess のフィールドではありません。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
IOException	ディスクエラーなどの I/O エラーが発生しました。またはストリームは閉じられています。
UnauthorizedAccessException	access が Write または ReadWrite であるのに、ファイルハンドルが読み取り専用に設定されているなど、指定したファイルハンドルに対する access 要求がオペレーティングシステムで許可されません。

解説

Close が呼び出されると、ハンドルも閉じられ、ファイルのハンドルカウントがデクリメントされます。

注意
特定のカルチャ設定で文字セットをコンパイルし、同じ文字を異なるカルチャ設定で取得すると、文字が正しく解釈されない場合があり、例外がスローされることもあります。

FileShare パラメータを指定しないタイプの FileStream コンストラクタに対しては、FileShare.Read が既定値です。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ファイルの拡張子を取得する。	Path.GetExtension
ファイルの絶対パスを取得する。	Path.GetFullPath
パスからファイル名と拡張子を取得する。	Path.GetFileName
ファイルの拡張子を変更する。	Path.ChangeExtension

.NET Framework のセキュリティ

FileIOPermission (ファイルの読み取り、書き込み、および追記を行うために必要なアクセス許可)。FileIOPermissionAccess.Read、FileIOPermissionAccess.Write、および FileIOPermissionAccess.Append (関連する列挙体)。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

FileStream プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	CanTimeout	現在のストリームがタイムアウトできるかどうかを決定する値を取得します。 ( Stream から継承されます。)
	ReadTimeout	ストリームがタイムアウト前に読み取りを試行する期間を決定する値を取得または設定します。 ( Stream から継承されます。)
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。 ( Stream から継承されます。)

参照

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む
基本のファイル I/O
方法 : 新しく作成されたデータファイルに対して読み書きする

FileStream メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	BeginRead	オーバーライドされます。非同期の読み取りを開始します。
	BeginWrite	オーバーライドされます。非同期の書き込みを開始します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。 ( Stream から継承されます。)
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。
	EndRead	オーバーライドされます。保留中の非同期読み取りが完了するまで待機します。
	EndWrite	オーバーライドされます。非同期の書き込みを終了し、I/O 操作が完了するまでブロックします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Flush	オーバーライドされます。ストリームに対応するすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetAccessControl	現在の FileStream オブジェクトが示すファイルのアクセス制御リスト (ACL: Access Control List) エントリをカプセル化する FileSecurity オブジェクトを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	Lock	読み取りアクセスを許可している間に他のプロセスによって FileStream が変更されるのを防ぎます。
	Read	オーバーライドされます。ストリームからバイトのブロックを読み取り、そのデータを特定のバッファに書き込みます。
	ReadByte	オーバーライドされます。ファイルからバイトを読み取り、読み取り位置を 1 バイト進めます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Seek	オーバーライドされます。ストリームの現在位置を特定の値に設定します。
	SetAccessControl	FileSecurity オブジェクトが示すアクセス制御リスト (ACL) エントリを、現在の FileStream オブジェクトが示すファイルに適用します。
	SetLength	オーバーライドされます。ストリーム長を特定の値に設定します。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。 ( Stream から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Unlock	他のプロセスにより以前にロックされたファイルの全部または一部へのアクセスを許可します。
	Write	オーバーライドされます。バッファのデータを使用して、ストリームにバイトのブロックを書き込みます。
	WriteByte	オーバーライドされます。ファイルストリームの現在位置にバイトを書き込みます。

プロテクトメソッド

	名前	説明
	CreateWaitHandle	WaitHandle オブジェクトを割り当てます。 ( Stream から継承されます。)
	Dispose	オーバーロードされます。オーバーライドされます。
	Finalize	オーバーライドされます。ガベージコレクタが FileStream を利用しているときに、リソースの解放およびその他のクリーンアップ操作を確実に実行します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

その他の技術情報

FileStream メンバ

同期および非同期の読み取り操作と書き込み操作をサポートするファイル用の Stream を公開します。

FileStream データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	FileStream	オーバーロードされます。 FileStream クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	CanTimeout	現在のストリームがタイムアウトできるかどうかを決定する値を取得します。(Stream から継承されます。)
	ReadTimeout	ストリームがタイムアウト前に読み取りを試行する期間を決定する値を取得または設定します。 (Stream から継承されます。)
	WriteTimeout	ストリームがタイムアウト前に書き込みを試行する期間を決定する値を取得または設定します。 (Stream から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	BeginRead	オーバーライドされます。非同期の読み取りを開始します。
	BeginWrite	オーバーライドされます。非同期の書き込みを開始します。
	Close	現在のストリームを閉じ、現在のストリームに関連付けられているすべてのリソース (ソケット、ファイルハンドルなど) を解放します。 (Stream から継承されます。)
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。
	EndRead	オーバーライドされます。保留中の非同期読み取りが完了するまで待機します。
	EndWrite	オーバーライドされます。非同期の書き込みを終了し、I/O 操作が完了するまでブロックします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Flush	オーバーライドされます。ストリームに対応するすべてのバッファをクリアし、バッファ内のデータを基になるデバイスに書き込みます。
	GetAccessControl	現在の FileStream オブジェクトが示すファイルのアクセス制御リスト (ACL: Access Control List) エントリをカプセル化する FileSecurity オブジェクトを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	Lock	読み取りアクセスを許可している間に他のプロセスによって FileStream が変更されるのを防ぎます。
	Read	オーバーライドされます。ストリームからバイトのブロックを読み取り、そのデータを特定のバッファに書き込みます。
	ReadByte	オーバーライドされます。ファイルからバイトを読み取り、読み取り位置を 1 バイト進めます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Seek	オーバーライドされます。ストリームの現在位置を特定の値に設定します。
	SetAccessControl	FileSecurity オブジェクトが示すアクセス制御リスト (ACL) エントリを、現在の FileStream オブジェクトが示すファイルに適用します。
	SetLength	オーバーライドされます。ストリーム長を特定の値に設定します。
	Synchronized	指定した Stream オブジェクトをラップするスレッドセーフな (同期された) ラッパーを作成します。 (Stream から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Unlock	他のプロセスにより以前にロックされたファイルの全部または一部へのアクセスを許可します。
	Write	オーバーライドされます。バッファのデータを使用して、ストリームにバイトのブロックを書き込みます。
	WriteByte	オーバーライドされます。ファイルストリームの現在位置にバイトを書き込みます。

プロテクトメソッド

	名前	説明
	CreateWaitHandle	WaitHandle オブジェクトを割り当てます。 (Stream から継承されます。)
	Dispose	オーバーロードされます。オーバーライドされます。
	Finalize	オーバーライドされます。ガベージコレクタが FileStream を利用しているときに、リソースの解放およびその他のクリーンアップ操作を確実に実行します。
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

その他の技術情報

>> 「FileStream」を含む用語の索引
FileStreamのページへのリンク

FileStreamとは？わかりやすく解説

FileStream クラス

ストリームの位置の変更の検出

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32, Boolean)

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

FileStream コンストラクタ

関連項目

その他の技術情報

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32, Boolean)

FileStream コンストラクタ (String, FileMode, FileAccess)

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32)

FileStream コンストラクタ (IntPtr, FileAccess, Boolean)

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32)

FileStream コンストラクタ (String, FileMode)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, Boolean)

FileStream コンストラクタ (SafeFileHandle, FileAccess)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, FileOptions)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32)

FileStream コンストラクタ (IntPtr, FileAccess)

FileStream プロパティ

関連項目

その他の技術情報

FileStream メソッド

関連項目

その他の技術情報

FileStream メンバ

関連項目

その他の技術情報

「FileStream」の関連用語

FileStreamとは？ わかりやすく解説

FileStream クラス

ストリームの位置の変更の検出

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32, Boolean)

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

FileStream コンストラクタ (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

FileStream コンストラクタ

関連項目

その他の技術情報

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32, Boolean)

FileStream コンストラクタ (String, FileMode, FileAccess)

FileStream コンストラクタ (IntPtr, FileAccess, Boolean, Int32)

FileStream コンストラクタ (IntPtr, FileAccess, Boolean)

FileStream コンストラクタ (SafeFileHandle, FileAccess, Int32)

FileStream コンストラクタ (String, FileMode)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, Boolean)

FileStream コンストラクタ (SafeFileHandle, FileAccess)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32, FileOptions)

FileStream コンストラクタ (String, FileMode, FileAccess, FileShare, Int32)

FileStream コンストラクタ (IntPtr, FileAccess)

FileStream プロパティ

関連項目

その他の技術情報

FileStream メソッド

関連項目

その他の技術情報

FileStream メンバ

関連項目

その他の技術情報

急上昇のことば

「FileStream」の関連用語

FileStreamとは？わかりやすく解説