IsolatedStorageFileStream.Read-Methode

Kopiert Bytes aus dem aktuellen gepufferten IsolatedStorageFileStream-Objekt in ein Array.

Namespace: System.IO.IsolatedStorage
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overrides Function Read ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
) As Integer
'Usage
Dim instance As IsolatedStorageFileStream
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 (
    byte[] buffer,
    int offset,
    int count
)

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

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

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

Parameter

• buffer
  Der zu lesende Puffer.

• offset
  Der Offset im Puffer, ab dem geschrieben werden soll.

• count
  Die maximale Anzahl der zu lesenden Bytes.

Rückgabewert

Die Anzahl der insgesamt in den buffer 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.

Hinweise

Der buffer-Parameter kann eine Instanz der Buffer-Klasse sein, oder ein Array von einem der folgenden Typen: Byte, SByte, Char, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single oder Double. Der offset-Parameter gibt den Offset des Bytes im Puffer, d. h. den Pufferindex an, ab dem geschrieben werden soll, und der count-Parameter gibt die maximale Anzahl der aus diesem Stream zu lesenden Bytes an. Der zurückgegebene Wert ist die Anzahl der tatsächlich gelesenen Bytes bzw. 0 (null), wenn das Streamende erreicht ist. Wenn der Lesevorgang erfolgreich ist, wird die aktuelle Position des Streams um die Anzahl der gelesenen Bytes erhöht. Wenn eine Ausnahme auftritt, wird die aktuelle Position des Streams nicht geändert.

Die Read-Methode behandelt den buffer-Parameter als Block von Bytes, wobei der tatsächliche Typ nicht berücksichtigt wird. Ebenso werden der offset-Parameter und der count-Parameter immer in Bytes angegeben. Für andere buffer-Parameter als Bytearrays bedeutet dies, dass ein Elementindex mit der Elementgröße in Bytes multipliziert werden muss, um einen korrekten Wert für offset oder count zu erhalten.

Die Read-Methode gibt nur dann 0 (null) zurück, wenn das Streamende erreicht ist. In allen anderen Fällen liest Read vor der Rückgabe immer mindestens ein Byte aus dem Stream. Wenn bei einem Aufruf von Read keine Daten aus dem IsolatedStorageFileStream-Objekt verfügbar sind, blockiert die Methode, bis mindestens ein Byte an Daten zurückgegeben werden kann.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

IsolatedStorageFileStream-Klasse
IsolatedStorageFileStream-Member
System.IO.IsolatedStorage-Namespace