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.

public:
 virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

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:

Weitere Informationen