DeflateStream.WriteAsync Méthode

Définition

Surcharges

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Écrit de façon asynchrone les octets compressés dans le flux Deflate sous-jacent à partir de la région de mémoire en lecture seule spécifiée.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified read-only memory region.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Écrit de façon asynchrone les octets compressés dans le flux Deflate sous-jacent à partir du tableau d’octets spécifié.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified byte array.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Écrit de façon asynchrone les octets compressés dans le flux Deflate sous-jacent à partir de la région de mémoire en lecture seule spécifiée.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified read-only memory region.

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Paramètres

buffer
ReadOnlyMemory<Byte>

Région de la mémoire dont sont issues les données à écrire.The region of memory to write data from.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests. La valeur par défaut est None.The default value is None.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Remarques

La WriteAsync méthode vous permet d’effectuer des opérations d’e/s gourmandes en ressources sans bloquer le thread principal.The WriteAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Cette considération de performance est particulièrement importante dans une application Windows 8.x StoreWindows 8.x Store ou une application Bureaudesktop où une longue opération de flux peut bloquer le thread d'interface utilisateur et faire que l'application s'affiche comme si elle ne fonctionnait pas.This performance consideration is particularly important in a Windows 8.x StoreWindows 8.x Store app or Bureaudesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Les méthodes Async sont utilisées conjointement avec les async Mots clés et await dans Visual Basic et C#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Utilisez la CanWrite propriété pour déterminer si l’instance actuelle prend en charge l’écriture.Use the CanWrite property to determine whether the current instance supports writing.

Si l’opération est annulée avant d’être terminée, la tâche retournée contient TaskStatus.Canceled la valeur de Task.Status la propriété.If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Écrit de façon asynchrone les octets compressés dans le flux Deflate sous-jacent à partir du tableau d’octets spécifié.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified byte array.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ array, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync (byte[] array, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Paramètres

array
Byte[]

Mémoire tampon qui contient les données à compresser.The buffer that contains the data to compress.

offset
Int32

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

count
Int32

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

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests. La valeur par défaut est None.The default value is None.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Remarques

La WriteAsync méthode vous permet d’effectuer des opérations d’e/s gourmandes en ressources sans bloquer le thread principal.The WriteAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Cette considération de performance est particulièrement importante dans une application Windows 8.x StoreWindows 8.x Store ou une application Bureaudesktop où une longue opération de flux peut bloquer le thread d'interface utilisateur et faire que l'application s'affiche comme si elle ne fonctionnait pas.This performance consideration is particularly important in a Windows 8.x StoreWindows 8.x Store app or Bureaudesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Les méthodes Async sont utilisées conjointement avec les async Mots clés et await dans Visual Basic et C#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Utilisez la CanWrite propriété pour déterminer si l’instance actuelle prend en charge l’écriture.Use the CanWrite property to determine whether the current instance supports writing.

Si l’opération est annulée avant d’être terminée, la tâche retournée contient TaskStatus.Canceled la valeur de Task.Status la propriété.If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

S’applique à