Writes data to a binary file.
' Usage My.Computer.FileSystem.WriteAllBytes(file ,data ,append) ' Declaration Public Sub WriteAllBytes( _ ByVal file As String, _ ByVal data As Byte(), _ ByVal append As Boolean _ )
The following conditions may create an exception:
The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\) (ArgumentException).
The path is not valid because it is Nothing or ends with a backslash (\) (ArgumentNullException).
The file is in use by another process or an I/O error occurs (IOException).
The path exceeds the system-defined maximum length (PathTooLongException).
A file or directory name in the path contains a colon (:) or is in an invalid format (NotSupportedException).
The user lacks necessary permissions to view the path (SecurityException).
If the append parameter is True, it appends the data to the file; otherwise data in the file is overwritten.
If the specified path, excluding the file name, is not valid, a DirectoryNotFoundException exception will be thrown. If the path is valid but the file does not exist, the file is created.
The WriteAllBytes method opens a file, writes to it, and then closes it. Code that uses the WriteAllBytes method is simpler than code that uses a BinaryWriter object. However, if you are adding data to a file using a loop, a BinaryWriter object can provide better performance because you only have to open and close the file once.
The following table lists an example of a task involving the My.Computer.FileSystem.WriteAllBytes method.
Write to a binary file
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Availability by Project Type
Windows Control Library
Web Control Library