Esporta (0) Stampa
Espandi tutto

Metodo Stream.ReadByte

Aggiornamento: novembre 2007

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.

Spazio dei nomi:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

public virtual int ReadByte()
public int ReadByte()
public function ReadByte() : int

Valore restituito

Tipo: System.Int32
Cast di byte senza segno in un Int32 o -1 se alla fine del flusso.

EccezioneCondizione
NotSupportedException

Il flusso non supporta la lettura.

ObjectDisposedException

Sono stati chiamati dei metodi dopo la chiusura del flusso.

Per un esempio di creazione di un file e di scrittura di testo in un file, vedere Procedura: scrivere testo su un file. Per un esempio di lettura di testo da un file, vedere Procedura: leggere testo da un file. Per un esempio di lettura e di scrittura in un file binario, vedere Procedura: leggere e scrivere su un file di dati appena creato.

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

Eventuali tentativi di modifica del flusso dopo la chiusura dello stesso possono generare un'eccezione ObjectDisposedException.

Note per gli implementatori:

L'implementazione predefinita su Stream crea una nuova matrice a singolo byte, quindi chiama il metodo Read. Sebbene formalmente corretta, questa soluzione non è efficace. Qualunque flusso dotato di buffer interno deve sottoporre a override questo metodo e fornire una versione più efficiente che legga direttamente il buffer, evitando l'assegnazione aggiuntiva della matrice a ogni chiamata.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC, Xbox 360

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supportato in: 3.5, 2.0, 1.0

XNA Framework

Supportato in: 2.0, 1.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft