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

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

FileSystem.vb

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

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 例外がスローされます。 パスが有効で、ファイルが存在しない場合は、ファイルが作成されます。

注意

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

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

終了	解決方法については、
バイナリ ファイルへの書き込み	方法 : Visual Basic でバイナリ ファイルに書き込む