Condividi tramite


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.

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

Cast di byte senza segno in un parametro Int32 oppure -1 se si trova alla fine del flusso.

Eccezioni

Il flusso non supporta la lettura.

Sono stati chiamati dei metodi dopo la chiusura del flusso.

Commenti

Utilizzare la proprietà per determinare se l'istanza CanRead corrente supporta la lettura.

I tentativi di modifica del flusso dopo la chiusura del flusso potrebbero generare un ObjectDisposedExceptionoggetto .

Note per gli eredi

L'implementazione predefinita in Stream crea una nuova matrice a byte singolo e quindi chiama Read(Byte[], Int32, Int32). Sebbene ciò sia formalmente corretto, è inefficiente. Qualsiasi flusso con un buffer interno deve eseguire l'override di questo metodo e fornire una versione molto più efficiente che legge il buffer direttamente, evitando l'allocazione di matrice aggiuntiva in ogni chiamata.

Si applica a

Vedi anche