C# FileStream.Read Method

最新推荐文章于 2025-03-28 19:00:00 发布

最新推荐文章于 2025-03-28 19:00:00 发布 · 184 阅读

本文介绍了从数据流中读取字节块并将其写入指定缓冲区的方法。该方法接受三个参数：目标字节数组、偏移量及最大读取字节数，并返回实际读取到的字节数。文章还列举了可能遇到的异常情况。

Reads a block of bytes from the stream and writes the data in a given buffer.

public override int Read(
	byte[] array,
	int offset,
	int count
)

Parameters

array

Type: System.Byte []

When this method returns, contains the specified byte array with the values betweenoffsetand (offset+count- 1)replaced by the bytes read from the current source.

offset

Type: System.Int32

The byte offset inarrayat which the read bytes will be placed.

count

Type: System.Int32

The maximum number of bytes to read.

Return Value

Type: System.Int32
The total number of bytes read into the buffer. This might be less than the number of bytes requested if that number of bytes are not currently available, or zero if the end of the stream is reached.

Exceptions

Exception	Condition
ArgumentNullException	arrayisnull.
ArgumentOutOfRangeException	offsetorcountis negative.
NotSupportedException	The stream does not support reading.
IOException	An I/O error occurred.
ArgumentException	offsetandcountdescribe an invalid range inarray.
ObjectDisposedException	Methods were called after the stream was closed.