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

  • リファレンス

定義

名前空間:
Microsoft.VisualBasic.MyServices
アセンブリ:
Microsoft.VisualBasic.dll
アセンブリ:
Microsoft.VisualBasic.Forms.dll

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

public:
 void WriteAllBytes(System::String ^ file, cli::array <System::Byte> ^ data, bool append);
public void WriteAllBytes (string file, byte[] data, bool append);
member this.WriteAllBytes : string * byte[] * bool -> unit
Public 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 示します。

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

適用対象

こちらもご覧ください