CryptoStream.Read(Byte[], Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает последовательность байтов из текущего потока и перемещает позицию внутри потока на число считанных байтов.
public:
override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public override int Read (byte[] buffer, int offset, int count);
override this.Read : byte[] * int * int -> int
Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer
Параметры
- buffer
- Byte[]
Массив байтов. Максимальное число байтов count
считывается из текущего потока и сохраняется в параметре buffer
.
- offset
- Int32
Позиция байта в параметре buffer
, с которой начинается сохранение данных, считанных из текущего потока.
- count
- Int32
Максимальное количество байтов, которое должно быть считано из текущего потока.
Возвращаемое значение
Общее количество байтов, считанных в буфер. Это число может быть меньше количества запрошенных байтов, если нужное число байтов в настоящее время недоступно, а также равняться нулю, если был достигнут конец потока.
Исключения
Режим CryptoStreamMode, связанный с текущим объектом CryptoStream не соответствует базовому потоку. Например, это исключение возникает при использовании режима Read с потоком, доступным только для записи.
Значение параметра offset
или count
меньше нуля.
Сумма параметров count
и offset
превышает длину буфера.
Комментарии
Начиная с .NET 6, этот метод может считывать не столько байтов, сколько было запрошено. Дополнительные сведения см. в разделе Частичные и нулевые операции чтения в DeflateStream, GZipStream и CryptoStream.