BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) 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.
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 -> IAsyncResultPublic Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResultParamè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.
