Stream.ReadByte Metodo

Definizione

Legge un byte dal flusso e sposta in avanti la posizione corrente all'interno del flusso di un byte o restituisce -1 se si trova alla fine del flusso.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

Restituisce

Int32

Cast di byte senza segno in un parametro Int32 oppure -1 se si trova alla fine del flusso.The unsigned byte cast to an Int32, or -1 if at the end of the stream.

Eccezioni

Il flusso non supporta la lettura.The stream does not support reading.

Sono stati chiamati dei metodi dopo la chiusura del flusso.Methods were called after the stream was closed.

Commenti

Utilizzare la CanRead proprietà per determinare se l'istanza corrente supporta la lettura.Use the CanRead property to determine whether the current instance supports reading.

Il tentativo di modificare il flusso dopo la chiusura del flusso potrebbe generare un' ObjectDisposedException .Attempts to manipulate the stream after the stream has been closed could throw an ObjectDisposedException.

Note per gli eredi

L'implementazione predefinita di Stream Crea una nuova matrice a byte singolo e quindi chiama Read(Byte[], Int32, Int32) .The default implementation on Stream creates a new single-byte array and then calls Read(Byte[], Int32, Int32). Sebbene sia formalmente corretto, non è efficiente.While this is formally correct, it is inefficient. Qualsiasi flusso con un buffer interno deve eseguire l'override di questo metodo e fornire una versione molto più efficiente che legge direttamente il buffer, evitando l'allocazione di matrici aggiuntiva a ogni chiamata.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.

Si applica a

Vedi anche