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.Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

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.The unsigned byte cast to an Int32, or -1 if at the end of the stream.

Ausnahmen

Lesevorgänge werden vom Stream nicht unterstützt.The stream does not support reading.

Es wurden Methoden aufgerufen, nachdem der Stream geschlossen wurde.Methods were called after the stream was closed.

Hinweise

Verwenden Sie CanRead die-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Lesevorgänge unterstütztUse the CanRead property to determine whether the current instance supports reading.

Versucht, den Datenstrom zu manipulieren, nachdem der Stream geschlossen wurde, ObjectDisposedExceptionkönnte eine auslösen.Attempts to manipulate the stream after the stream has been closed could throw an ObjectDisposedException.

Hinweise für Vererber

Die Standard Implementierung von Stream erstellt ein neues Einzel Byte Array und ruft Read(Byte[], Int32, Int32)dann auf.The default implementation on Stream creates a new single-byte array and then calls Read(Byte[], Int32, Int32). Obwohl dies formal korrekt ist, ist es ineffizient.While this is formally correct, it is inefficient. Jeder Datenstrom mit einem internen Puffer sollte diese Methode überschreiben und eine wesentlich effizientere Version bereitstellen, die den Puffer direkt liest, wobei die zusätzliche Array Zuordnung bei jedem-Befehl vermieden wird.Any stream with an internal buffer should override this method and provide a much more efficient version that reads the buffer directly, avoiding the extra array allocation on every call.

Gilt für:

Siehe auch