Export (0) Print
Expand All
2 out of 2 rated this helpful - Rate this topic

File.ReadAllBytes Method

Note: This method is new in the .NET Framework version 2.0.

Opens a binary file, reads the contents of the file into a byte array, and then closes the file.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

public:
static array<unsigned char>^ ReadAllBytes (
	String^ path
)
public static byte[] ReadAllBytes (
	String path
)
public static function ReadAllBytes (
	path : String
) : byte[]

Parameters

path

The file to open for reading.

Return Value

A byte array containing the contents of the file.
Exception typeCondition

ArgumentException

path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path is a null reference (Nothing in Visual Basic).

PathTooLongException

The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.

DirectoryNotFoundException

The specified path is invalid (for example, it is on an unmapped drive).

IOException

An I/O error occurred while opening the file.

UnauthorizedAccessException

path specified a file that is read-only.

-or-

This operation is not supported on the current platform.

-or-

path specified a directory.

-or-

The caller does not have the required permission.

FileNotFoundException

The file specified in path was not found.

NotSupportedException

path is in an invalid format.

SecurityException

The caller does not have the required permission.

Given a file path, this method opens the file, reads the contents of the file into a byte array, and then closes the file.

This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.