Stream.Read-Methode

Verwenden Sie die CanRead-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Lesevorgänge unterstützt. Verwenden Sie die - Methode, um ReadAsync aus dem aktuellen Stream asynchron zu lesen.

Die Implementierungen dieser Methode lesen maximal count Bytes aus dem aktuellen Stream und speichern diese beginnend bei offset im buffer. Die aktuelle Position im Stream wird um die Anzahl der gelesenen Bytes nach vorne verschoben. Wenn eine Ausnahme auftritt, wird die Position im Stream jedoch nicht geändert. Die Implementierungen geben die Anzahl der gelesenen Bytes zurück. Falls keine Daten verfügbar sind, blockiert die Implementierung solange, bis mindestens ein Byte mit Daten gelesen werden kann. Read gibt nur 0 zurück, wenn es keine weiteren Daten im Stream gibt, und nichts mehr erwartet wird (z. B. ein geschlossener Socket oder ein Dateiende). Eine Implementierung kann weniger Bytes als angefordert zurückgeben, auch wenn noch nicht das Ende des Streams erreicht ist.

Verwenden Sie BinaryReader für das Lesen primitiver Datentypen.

Im folgenden Beispiel wird veranschaulicht, wie mithilfe von Read ein Datenblock gelesen wird.

using System;
using System.IO;

public class Block
{
    public static void Main()
    {
        Stream s = new MemoryStream();
        for (int i = 0; i < 100; i++)
        {
            s.WriteByte((byte)i);
        }
        s.Position = 0;

        // Now read s into a byte buffer.
        byte[] bytes = new byte[s.Length];
        int numBytesToRead = (int) s.Length;
        int numBytesRead = 0;
        while (numBytesToRead > 0)
        {
            // Read may return anything from 0 to 10.
            int n = s.Read(bytes, numBytesRead, 10);
            // The end of the file is reached.
            if (n == 0)
            {
                break;
            }
            numBytesRead += n;
            numBytesToRead -= n;
        }
        s.Close();
        // numBytesToRead should be 0 now, and numBytesRead should
        // equal 100.
        Console.WriteLine("number of bytes read: {0:d}", numBytesRead);
    }
}

.NET Framework

.NET Framework Client Profile

Portable Klassenbibliothek

.NET für Windows Store-Apps

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen