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

現在のストリームから読み取る最大バイト数。

戻り値

バッファーに読み取られた合計バイト数。 要求されたバイト数を読み取れなかった場合、この値は要求されたバイト数より小さくなることがあります。ストリームの末尾に達していた場合は 0 になります。

例外

現在の CryptoStreamMode オブジェクトと関連付けられた CryptoStream が、使用されているストリームと一致しません。 Read を書き込み専用のストリームで使用した場合などに、この例外がスローされます。

offset または count が 0 未満です。

count パラメーターと offset パラメーターの合計が、バッファーの長さを超えています。

注釈

.NET 6 以降では、このメソッドは要求されたバイト数を読み取らない可能性があります。 詳細については、「 DeflateStream、GZipStream、CryptoStream の部分読み取りと 0 バイト読み取り」を参照してください。

適用対象

こちらもご覧ください