Partager via


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

Définition

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

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

Exceptions

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

buffer a la valeur null.

offset ou count est un nombre négatif.

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 à