CryptoStream.Read-Methode

Liest eine Folge von Bytes aus dem aktuellen CryptoStream und verschiebt die Position im Stream um die Anzahl der gelesenen Bytes nach vorn.

Namespace: System.Security.Cryptography
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Function Read ( _
    <InAttribute> <OutAttribute> buffer As Byte(), _
    offset As Integer, _
    count As Integer _
) As Integer
'Usage
Dim instance As CryptoStream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.Read(buffer, offset, count)

public override int Read (
    [InAttribute] [OutAttribute] byte[] buffer,
    int offset,
    int count
)

public:
virtual int Read (
    [InAttribute] [OutAttribute] array<unsigned char>^ buffer, 
    int offset, 
    int count
) override

public int Read (
    /** @attribute InAttribute() */ /** @attribute OutAttribute() */ byte[] buffer, 
    int offset, 
    int count
)

public override function Read (
    buffer : byte[], 
    offset : int, 
    count : int
) : int

Parameter

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

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

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

Rückgabewert

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

Ausnahmetyp	Bedingung
NotSupportedException	Der dem aktuellen CryptoStream-Objekt zugeordnete CryptoStreamMode 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	Der offset-Parameter ist kleiner als 0 (null). – oder – Der count-Parameter ist kleiner als 0 (null).
ArgumentException	Die Summe von count-Parameter und offset-Parameter ist größer als die Länge des Puffers.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

CryptoStream-Klasse
CryptoStream-Member
System.Security.Cryptography-Namespace

Weitere Ressourcen

Kryptografische Dienste