Stream.ReadByte Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
Stream.cs
Source:
Stream.cs
Source:
Stream.cs

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

Int32

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

Eccezioni

NotSupportedException

Il flusso non supporta la lettura.

ObjectDisposedException

Sono stati chiamati dei metodi dopo la chiusura del flusso.

Commenti

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

I tentativi di modificare il flusso dopo la chiusura del flusso potrebbero generare un'eccezione ObjectDisposedException.

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 direttamente il buffer, evitando l'allocazione di matrici aggiuntiva in ogni chiamata.

Si applica a

Vedi anche