Stream.WriteByte(Byte) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Scrive un byte nella posizione corrente nel flusso e sposta in avanti la posizione all'interno del flusso di un byte.
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
Si verifica un errore di I/O.
Il flusso non supporta la scrittura o il flusso è già chiuso.
I metodi sono stati chiamati dopo la chiusura del flusso.
Commenti
Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.
Note per gli eredi
L'implementazione predefinita in Stream crea una nuova matrice a byte singolo e quindi chiama Write(Byte[], Int32, Int32). Anche se ciò è 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 di matrici aggiuntiva in ogni chiamata.