CryptoStream.Read(Byte[], Int32, Int32) Methode

Definition

Liest eine Bytesequenz aus dem aktuellen Stream und setzt die Position in diesem Stream um die Anzahl der gelesenen Bytes nach vorn.

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

Parameter

buffer
Byte[]

Ein Bytearray. Aus dem aktuellen Stream werden maximal count Bytes gelesen und im buffer gespeichert.

offset
Int32

Der Byteoffset im buffer, ab dem die aus dem aktuellen Stream gelesenen Daten gespeichert werden.

count
Int32

Die maximale Anzahl an Bytes, die aus dem aktuellen Stream gelesen werden sollen.

Gibt zurück

Die Gesamtanzahl der in den Puffer gelesenen Bytes. Dies kann weniger als die Anzahl der angeforderten Bytes sein, wenn diese Anzahl an Bytes derzeit nicht verfügbar ist, oder 0 (null), wenn das Streamende erreicht ist.

Ausnahmen

Der dem aktuellen CryptoStreamMode-Objekt zugeordnete CryptoStream stimmt nicht mit dem zugrunde liegenden Stream überein. Diese Ausnahme wird beispielsweise ausgelöst, wenn Read mit einem zugrunde liegenden Stream verwendet wird, für den die Zugriffsart Nur Schreiben gilt.

offset oder count ist kleiner als 0.

Die Summe aus count-Parameter und offset-Parameter ist größer als die Länge des Puffers.

Hinweise

Ab .NET 6 liest diese Methode möglicherweise nicht mehr so viele Bytes, wie angefordert wurden. Weitere Informationen finden Sie unter Partielle und Null-Byte-Lesevorgänge in DeflateStream, GZipStream und CryptoStream.

Gilt für:

Weitere Informationen