Stream.WriteByte(Byte) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit un octet à la position actuelle dans le flux et avance la position dans le flux d’un octet.
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)
Paramètres
- value
- Byte
Octet à écrire dans le flux.
Exceptions
Une erreur d’E/S se produit.
Le flux ne prend pas en charge l’écriture, ou le flux est déjà fermé.
Les méthodes ont été appelées après la fermeture du flux.
Remarques
Utilisez la CanWrite propriété pour déterminer si l’instance actuelle prend en charge l’écriture.
Notes pour les héritiers
L’implémentation par défaut sur crée Stream un tableau d’octets unique, puis appelle Write(Byte[], Int32, Int32). Bien que cela soit officiellement correct, il est inefficace. Tout flux avec une mémoire tampon interne doit remplacer cette méthode et fournir une version beaucoup plus efficace qui écrit directement dans la mémoire tampon, évitant ainsi l’allocation de tableau supplémentaire sur chaque appel.