Stream.WriteByte(Byte) Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

Stream.cs

Scrive un byte nella posizione corrente del flusso e sposta in avanti di un byte la posizione del flusso.

public:
 virtual void WriteByte(System::Byte value);

public virtual void WriteByte (byte value);

abstract member WriteByte : byte -> unit
override this.WriteByte : byte -> unit

Public Overridable Sub WriteByte (value As Byte)

Parametri

value

Byte

Byte da scrivere nel flusso.

Eccezioni

IOException

Si è verificato un errore di I/O.

NotSupportedException

Il flusso non supporta la scrittura o è già chiuso.

ObjectDisposedException

Sono stati chiamati dei metodi dopo la chiusura del flusso.

Commenti

Utilizzare la proprietà per determinare se l'istanza corrente supporta la CanWrite scrittura.

Note per gli eredi

L'implementazione predefinita in Stream crea una nuova matrice a byte singolo e quindi chiama Write(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 scrive direttamente nel buffer, evitando l'allocazione aggiuntiva della matrice in ogni chiamata.

Vedi anche

• File e Stream I/O
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file