File.ReadAllBytes メソッド

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

File.ReadAllBytes メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

バイナリ ファイルを開き、ファイルの内容をバイト配列に読み取った後、ファイルを閉じます。

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

Visual Basic (宣言)

Public Shared Function ReadAllBytes
 ( _
    path As String _
) As Byte()

Visual Basic (使用法)

Dim path As String
Dim returnValue As Byte()

returnValue = File.ReadAllBytes(path)

C#

public static byte[] ReadAllBytes (
    string path
)

C++

public:
static array<unsigned char>^ ReadAllBytes
 (
    String^ path
)

J#

public static byte[] ReadAllBytes (
    String path
)

JScript

public static function ReadAllBytes
 (
    path : String
) : byte[]

パラメータ

path

読み取り用に開かれるファイル。

戻り値
ファイルの内容を格納しているバイト配列。

例外

例外の種類	条件
ArgumentException	path が、長さが 0 の文字列であるか、空白しか含んでいないか、または InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいます。
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
DirectoryNotFoundException	指定したパスが無効です (割り当てられていないドライブであるなど)。
IOException	ファイルを開くときに、I/O エラーが発生しました。
UnauthorizedAccessException	path によって、読み取り専用のファイルが指定されました。 または この操作は、現在のプラットフォームではサポートされていません。 または path によってディレクトリが指定されました。 または 呼び出し元に、必要なアクセス許可がありません。
FileNotFoundException	path で指定されたファイルが見つかりませんでした。
NotSupportedException	path の形式が無効です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

ファイル パスを指定すると、このメソッドはそのファイルを開き、ファイルの内容をバイト配列に読み取った後、ファイルを閉じます。

このメソッドは、バイト順マークの存在に基づいて、ファイルのエンコーディングを自動的に検出することを試みます。エンコーディング形式 UTF-8 および UTF-32 (ビッグ エンディアンとリトル エンディアンの両方) を検出できます。

.NET Framework のセキュリティ

• FileIOPermission  (ファイルまたはディレクトリから読み取るために必要なアクセス許可)。FileIOPermissionAccess.Read (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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