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

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Quelle:

CryptoStream.cs

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

Int32

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

NotSupportedException

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.

ArgumentOutOfRangeException

offset oder count ist kleiner als 0.

ArgumentException

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.

Weitere Informationen

• Kryptografische Dienste