MemoryStream.Write 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.
Surcharges
Write(ReadOnlySpan<Byte>) |
Écrit une séquence d’octets de l’élément |
Write(Byte[], Int32, Int32) |
Écrit un bloc d'octets dans le flux actuel en utilisant des données lues dans une mémoire tampon. |
Write(ReadOnlySpan<Byte>)
- Source:
- MemoryStream.cs
- Source:
- MemoryStream.cs
- Source:
- MemoryStream.cs
Écrit une séquence d’octets de l’élément source
dans le flux de mémoire actuel et avance la position actuelle dans ce flux de mémoire du nombre d’octets écrits.
public:
override void Write(ReadOnlySpan<System::Byte> source);
public:
override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> source);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (source As ReadOnlySpan(Of Byte))
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))
Paramètres
- sourcebuffer
- ReadOnlySpan<Byte>
Région de la mémoire. Cette méthode copie le contenu de cette zone dans le flux mémoire actuel.
S’applique à
Write(Byte[], Int32, Int32)
- Source:
- MemoryStream.cs
- Source:
- MemoryStream.cs
- Source:
- MemoryStream.cs
Écrit un bloc d'octets dans le flux actuel en utilisant des données lues dans une mémoire tampon.
public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)
Paramètres
- buffer
- Byte[]
Mémoire tampon dont sont issues les données à écrire.
- offset
- Int32
Dans buffer
, décalage d'octet de base zéro auquel commencer la copie des octets dans le flux actuel.
- count
- Int32
Nombre maximal d'octets à écrire.
Exceptions
buffer
a la valeur null
.
Le flux ne prend pas en charge l'écriture. Pour plus d’informations, consultez CanWrite.
- ou -
La position actuelle est à moins de count
octets de la fin du flux et la capacité ne peut pas être modifiée.
offset
soustrait de la longueur de la mémoire tampon est inférieur à count
.
offset
ou count
est négatif.
Une erreur d’E/S se produit.
L’instance du flux actuel est fermée.
Exemples
Cet exemple de code fait partie d’un exemple plus grand fourni pour la MemoryStream classe .
// Write the first string to the stream.
memStream->Write( firstString, 0, firstString->Length );
// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);
' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)
Remarques
Cette méthode se substitue à Write.
Le offset
paramètre donne le décalage du premier octet à buffer
partir duquel écrire, et le count
paramètre donne le nombre d’octets à écrire. Si l’opération d’écriture réussit, la position actuelle dans le flux est avancée par le nombre d’octets écrits. Si une exception se produit, la position actuelle dans le flux est inchangée.
À l’exception d’un MemoryStream
construit avec un paramètre byte[], les opérations d’écriture à la fin d’un MemoryStream
développez le MemoryStream
.
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