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

Définition

Espace de noms:
System.IO
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Commence une opération d’écriture asynchrone. (Envisagez d’utiliser 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);
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 contenant des données à écrire dans le flux actuel.

offset
Int32

Décalage d’octet de base zéro dans buffer lequel commencer la copie d’octets dans le flux actuel.

count
Int32

Nombre maximal d’octets à écrire.

callback
AsyncCallback

Méthode à appeler lorsque l’opération d’écriture asynchrone est terminée.

state
Object

Objet fourni par l’utilisateur qui distingue cette demande d’écriture asynchrone particulière d’autres requêtes.

Retours

IAsyncResult

Objet qui fait référence à l’écriture asynchrone, qui peut toujours être en attente.

Exceptions

ArgumentException

buffer longueur moins offset est inférieure à count.

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

offset ou count est 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 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 les opérations de fichier asynchrones.

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

S’applique à