My.Computer.FileSystem.ReadAllBytes メソッド

[アーティクル]
09/30/2008

更新 : 2007 年 11 月

ファイルの内容をバイト配列で返します。

' Usage
Dim value As Byte() = My.Computer.FileSystem.ReadAllBytes(file)
' Declaration
Public Function ReadAllBytes( _
   ByVal file As String _
) As Byte()

パラメータ

file
読み込むファイルを指定する String です。必ず指定します。

戻り値

ファイルの内容が格納された Byte 配列。

例外

例外がスローされる可能性のある状態を次に示します。

パスが無効です。1) 長さが 0 の文字列である、2) 空白だけが含まれている、3) 無効な文字が含まれている、4) デバイスパスである (\\.\ で開始されている)、のいずれかの理由が考えられます (ArgumentException)。
ファイル名が円記号 (\) で終わっています (ArgumentException)。
パスが Nothing であるため、有効ではありません (ArgumentNullException)。
ファイルが存在しない場合 (FileNotFoundException)
ファイルが別のプロセスで使用中か、または I/O エラーが起きています (IOException)。
パスがシステムで定義されている最大長 (PathTooLongException) を超えています。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、または形式が無効です (NotSupportedException)。
文字列をバッファに書き込むための十分なメモリがありません (OutOfMemoryException)。
ユーザーがパスを表示するのに必要なアクセス許可を持っていません (SecurityException)。

解説

My.Computer.FileSystem オブジェクトの ReadAllBytes メソッドを使うと、バイナリファイルを読み取ることができます。ファイルの内容はバイト配列で返されます。

ファイル名からファイルの内容を判断しないでください。たとえば、Form1.vb というファイルが Visual Basic のソースファイルではない可能性もあります。アプリケーションでデータを使用する前に、入力をすべて検証してください。

処理手順

My.Computer.FileSystem.ReadAllBytes メソッドに関連するタスクの例を次の表に示します。

目的	参照項目
バイナリファイルからの読み取り	方法 : Visual Basic でバイナリファイルを読み取る

使用例

ファイル C:/Documents and Settings/selfportrait.jpg. を読み取る例は次のようになります。

My.Computer.FileSystem.ReadAllBytes _
("C:/Documents and Settings/selfportrait.jpg")

必要条件

名前空間 : Microsoft.VisualBasic.MyServices

クラス : FileSystemProxy (FileSystem へのアクセスを可能にします)

アセンブリ : Microsoft Visual Basic ランタイム (Microsoft.VisualBasic.dll 内)

使用可能なプロジェクトの種類

プロジェクトの種類	使用可/不可
Windows アプリケーション	可
クラスライブラリ	可
コンソールアプリケーション	可
Windows コントロールライブラリ	可
Web コントロールライブラリ	可
Windows サービス	可
Web サイト	可

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。

詳細については、「コードアクセスセキュリティ」および「アクセス許可の要求」を参照してください。

参照

My.Computer.FileSystem オブジェクト

ReadAllBytes

その他の技術情報

Visual Basic でのファイルの読み取り

次の方法で共有