Auf Englisch lesen

Freigeben über


Stream.ReadByte Methode

Definition

Liest ein Byte aus dem Stream und erhöht die Position im Stream um ein Byte, oder gibt -1 zurück, wenn das Ende des Streams erreicht ist.

C#
public virtual int ReadByte ();

Gibt zurück

Das Byte ohne Vorzeichen, umgewandelt in Int32, oder -1, wenn das Ende des Streams erreicht ist.

Ausnahmen

Lesevorgänge werden vom Stream nicht unterstützt.

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.

Hinweise

Verwenden Sie die CanRead -Eigenschaft, um zu bestimmen, ob die aktuelle instance Lesevorgänge unterstützt.

Versuche, den Stream zu bearbeiten, nachdem der Stream geschlossen wurde, können einen ObjectDisposedExceptionauslösen.

Hinweise für Vererber

Die Standardimplementierung für Stream erstellt ein neues Einzelbytearray und ruft dann auf Read(Byte[], Int32, Int32). Dies ist zwar formal richtig, aber ineffizient. Jeder Stream mit einem internen Puffer sollte diese Methode außer Kraft setzen und eine viel effizientere Version bereitstellen, die den Puffer direkt liest, wodurch die zusätzliche Arrayzuordnung bei jedem Aufruf vermieden wird.

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Weitere Informationen