BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: BufferedStream.cs

Source:: BufferedStream.cs

Source:: BufferedStream.cs

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.

Débute une opération d'écriture asynchrone. (Utilisez WriteAsync(Byte[], Int32, Int32, CancellationToken) à la place.)

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);

public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);

public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);

public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);

override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

buffer: Byte[]

Mémoire tampon qui contient les données à écrire dans le flux actuel.

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.

callback: AsyncCallback

Méthode à appeler quand l'opération d'écriture asynchrone est terminée.

state: Object

Objet fourni par l'utilisateur qui distingue cette requête d'écriture asynchrone des autres requêtes.

Retours

IAsyncResult

Objet qui référence l’écriture asynchrone qui pourrait toujours être en attente.

Exceptions

ArgumentException

La longueur debuffer moins offset est inférieure à count.

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

offset ou count est un nombre négatif.

NotSupportedException

Le flux ne prend pas en charge l'écriture.

Remarques

Dans .NET Framework 4 et versions antérieures, vous devez utiliser des méthodes telles que BeginWrite et EndWrite pour implémenter des opérations de fichier asynchrones. Ces méthodes sont toujours disponibles dans .NET Framework 4.5 pour prendre en charge le code hérité ; Toutefois, les nouvelles méthodes asynchrones, telles que ReadAsync, WriteAsyncet FlushAsync, vous aident à implémenter plus facilement des opérations de fichier asynchrones.

EndWrite doit être appelé exactement une fois sur chaque IAsyncResult de BeginWrite. EndWrite bloquera jusqu’à ce que l’opération d’E/S soit terminée.

S’applique à