FileStream コンストラクタとは何？わかりやすく解説 Weblio辞書

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

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)

C#

[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
)

J#

/** @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 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

メモ : このコンストラクタは、.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)

C#

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
)

J#

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

メモ : このコンストラクタは、.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)

C#

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
)

J#

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" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

この 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

使用例

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

C#

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 メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

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

参照

その他の技術情報

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

メモ : このコンストラクタは、.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)

C#

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

C++

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

J#

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 要求がオペレーティングシステムで許可されません。

解説

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 のセキュリティ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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)

C#

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

C++

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

J#

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

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

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)

C#

[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
)

J#

/** @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 要求がオペレーティングシステムで許可されません。

解説

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 のセキュリティ

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

プラットフォーム

バージョン情報

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

参照

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

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

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)

C#

[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
)

J#

/** @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 バイトの既定のバッファサイズが付与されます。

FileStream は、ハンドルを排他的に制御していると見なされます。FileStream がハンドルも保持しているときに、読み取り、書き込み、またはシークを実行すると、データが破損することがあります。データを保護するために、ハンドルを使用する前に Flush を呼び出し、ハンドルの使用後は 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 クラス
FileStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

メモ : このコンストラクタは、.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)

C#

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

C++

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

J#

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 要求がオペレーティングシステムで許可されません。

解説

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 のセキュリティ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

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)

C#

public FileStream (
    string path,
    FileMode mode
)

C++

public:
FileStream (
    String^ path, 
    FileMode mode
)

J#

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

C#

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();
   }

}

J#

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

名前空間: 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)

C#

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

C++

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

J#

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 共有のファイルも含まれます。

コンストラクタにはファイルへの読み取り/書き込みアクセス権が付与されます。ファイルは共有読み取りモードで開きます。そのため、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

使用例

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

Visual Basic

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

C#

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
 );

J#

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

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)

C#

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
)

J#

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

C#

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 );
}

J#

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 クラス
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

メモ : このコンストラクタは、.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)

C#

public FileStream (
    SafeFileHandle handle,
    FileAccess access
)

C++

public:
FileStream (
    SafeFileHandle^ handle, 
    FileAccess access
)

J#

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 が呼び出されると、ハンドルも閉じられ、ファイルのハンドルカウントがデクリメントされます。

FileStream は、ハンドルを排他的に制御していると見なされます。FileStream がハンドルも保持しているときに、読み取り、書き込み、またはシークを実行すると、データが破損することがあります。データを保護するために、ハンドルを使用する前に Flush を呼び出し、ハンドルの使用後は 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 クラス
FileStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

メモ : このコンストラクタは、.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)

C#

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
)

J#

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

C#

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

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)

C#

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
)

J#

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

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

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)

C#

[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
)

J#

/** @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 が呼び出されると、ハンドルも閉じられ、ファイルのハンドルカウントがデクリメントされます。

FileStream は、ハンドルを排他的に制御していると見なされます。FileStream がハンドルも保持しているときに、読み取り、書き込み、またはシークを実行すると、データが破損することがあります。データを保護するために、ハンドルを使用する前に Flush を呼び出し、ハンドルの使用後は 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 クラス
FileStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

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 コンストラクタ (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 コンストラクタとは？わかりやすく解説