FileStream.Write Méthode

Définition

Surcharges

Write(ReadOnlySpan<Byte>)

Écrit une séquence d’octets depuis une plage en lecture seule dans le flux de fichier actuel et avance la position actuelle dans ce flux de fichier du nombre d’octets écrits.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

Write(Byte[], Int32, Int32)

Écrit un bloc d'octets dans le flux de fichier.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>)

Écrit une séquence d’octets depuis une plage en lecture seule dans le flux de fichier actuel et avance la position actuelle dans ce flux de fichier du nombre d’octets écrits.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Paramètres

buffer
ReadOnlySpan<Byte>

Région de la mémoire.A region of memory. Cette méthode copie le contenu de cette zone dans le flux de fichier actuel.This method copies the contents of this region to the current file stream.

Remarques

Utilisez la propriété CanWrite pour déterminer si l’instance actuelle prend en charge l’écriture.Use the CanWrite property to determine whether the current instance supports writing. Utilisez la méthode WriteAsync pour écrire de façon asynchrone dans le flux actuel.Use the WriteAsync method to write asynchronously to the current stream.

Si l’opération d’écriture réussit, la position dans le flux de fichier avance du nombre d’octets écrits.If the write operation is successful, the position within the file stream advances by the number of bytes written. Si une exception se produit, la position dans le flux de fichier reste inchangée.If an exception occurs, the position within the file stream remains unchanged.

Write(Byte[], Int32, Int32)

Écrit un bloc d'octets dans le flux de fichier.Writes a block of bytes to the file stream.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public override void Write (byte[] array, int offset, int count);
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)

Paramètres

array
Byte[]

Mémoire tampon qui contient les données à écrire dans le flux.The buffer containing data to write to the stream.

offset
Int32

Dans array, décalage d'octet de base zéro à partir duquel commencer la copie des octets dans le flux.The zero-based byte offset in array from which to begin copying bytes to the stream.

count
Int32

Nombre maximal d'octets à écrire.The maximum number of bytes to write.

Exceptions

array est null.array is null.

offset et count décrivent une plage non valide dans array.offset and count describe an invalid range in array.

offset ou count est un nombre négatif.offset or count is negative.

Une erreur d'E/S s'est produite.An I/O error occurred.

- ou --or-

Un autre thread a peut-être provoqué une modification inattendue de la position du descripteur de fichier du système d’exploitation.Another thread may have caused an unexpected change in the position of the operating system's file handle.

Le flux est fermé.The stream is closed.

L’instance du flux actuel ne prend pas en charge l’écriture.The current stream instance does not support writing.

Exemples

Cet exemple de code fait partie d’un exemple plus complet fourni pour la méthode Lock.This code example is part of a larger example provided for the Lock method.

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount( tempString ) );
}

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString), 
        0, uniEncoding.GetByteCount(tempString));
}
' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Remarques

Cette méthode se substitue à Write.This method overrides Write.

Le paramètre offset indique l’offset de l’octet dans array (l’index de mémoire tampon) à partir duquel commencer la copie, tandis que le paramètre count indique le nombre d’octets qui seront écrits dans le flux.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin copying, and the count parameter gives the number of bytes that will be written to the stream. Si l’opération d’écriture réussit, la position actuelle du flux est avancée du nombre d’octets écrits.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Si une exception se produit, la position actuelle du flux est inchangée.If an exception occurs, the current position of the stream is unchanged.

Notes

Utilisez la propriété CanWrite pour déterminer si l’instance actuelle prend en charge l’écriture.Use the CanWrite property to determine whether the current instance supports writing. Pour plus d'informations, consultez CanWrite.For additional information, see CanWrite.

N’interrompez pas un thread effectuant une opération d’écriture.Do not interrupt a thread that is performing a write operation. Bien que l’application puisse sembler s’exécuter correctement après le déblocage du thread, l’interruption peut réduire les performances et la fiabilité de votre application.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

Voir aussi

S’applique à