FileSystem.WriteAllBytes(String, Byte[], Boolean) メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.dll

バイナリ ファイルにデータを書き込みます。

public:
 static void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);

public static void WriteAllBytes(string file, byte[] data, bool append);

static member WriteAllBytes : string * byte[] * bool -> unit

Public Shared Sub WriteAllBytes (file As String, data As Byte(), append As Boolean)

パラメーター

file

String

書き込むファイルのパスと名前。

data

Byte[]

ファイルに書き込むデータ。

append

Boolean

True ファイルの内容に追加する場合。ファイルの内容を上書きする False 。 既定値は False です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

file は Nothingです。

FileNotFoundException

ファイルが存在しません。

IOException

ファイルが別のプロセスで使用されているか、I/O エラーが発生します。

PathTooLongException

パスがシステム定義の最大長を超えています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。

OutOfMemoryException

バッファーに文字列を書き込むのに十分なメモリがありません。

SecurityException

ユーザーには、パスを表示するために必要なアクセス許可がありません。

例

次の使用例は、データ配列 CustomerData をファイル CollectedDataに追加します。

My.Computer.FileSystem.WriteAllBytes(
  "C:\MyDocuments\CustomerData", CustomerData, True)

注釈

指定したパス (ファイル名を除く) が無効な場合は、 DirectoryNotFoundException 例外がスローされます。 パスが有効であっても、ファイルが存在しない場合は、ファイルが作成されます。

Note

WriteAllBytes メソッドは、ファイルを開き、ファイルに書き込んでから閉じます。 WriteAllBytes メソッドを使用するコードは、BinaryWriter オブジェクトを使用するコードよりも簡単です。 ただし、ループを使用してファイルにデータを追加する場合、ファイルを開いて閉じる必要があるのは 1 回だけであるため、 BinaryWriter オブジェクトのパフォーマンスが向上します。

次の表に、 My.Computer.FileSystem.WriteAllBytes メソッドを含むタスクの例を示します。

ターゲット	参照先
バイナリ ファイルへの書き込み	方法: Visual Basic