Stream.WriteByte(Byte) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

Stream.cs

Écrit un octet à la position actuelle dans le flux et avance d'un octet la position dans le flux.

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

IOException

Une erreur d’E/S se produit.

NotSupportedException

Le flux ne prend pas en charge l’écriture ou bien il est déjà fermé.

ObjectDisposedException

Des méthodes ont été appelées après la fermeture du flux.

Remarques

Utilisez la CanWrite propriété pour déterminer si le instance actuel prend en charge l’écriture.

Notes pour les héritiers

L’implémentation par défaut sur Stream crée un tableau sur un octet, puis appelle Write(Byte[], Int32, Int32). Bien que cela soit formellement 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, ce qui évite l’allocation de tableau supplémentaire à chaque appel.

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier