DeflateStream.WriteAsync Metodo

Definizione

Overload

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Scrive in modo asincrono i byte compressi nel flusso Deflate sottostante dall'area di memoria di sola lettura specificata.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified read-only memory region.

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

Scrive in modo asincrono i byte compressi nel flusso Deflate sottostante dalla matrice di byte specificata.Asynchronously writes compressed bytes to the underlying Deflate stream from the specified byte array.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Scrive in modo asincrono i byte compressi nel flusso Deflate sottostante dall'area di memoria di sola lettura specificata.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 = default);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametri

buffer
ReadOnlyMemory<Byte>

L'area di memoria da cui scrivere i dati.The region of memory to write data from.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.The token to monitor for cancellation requests. Il valore predefinito è None.The default value is None.

Restituisce

ValueTask

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

Commenti

Il WriteAsync metodo consente di eseguire operazioni di i/O a elevato utilizzo di risorse senza bloccare il thread principale.The WriteAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Questa considerazione sulle prestazioni è particolarmente importante in un'app di Windows 8. x Store o in un'app desktop in cui un'operazione di flusso che richiede molto tempo può bloccare il thread dell'interfaccia utente e fare in modo che l'app appaia come se non fosse funzionante.This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. I metodi asincroni vengono usati insieme alle async await parole chiave e in Visual Basic e C#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing.

Se l'operazione viene annullata prima del completamento, l'attività restituita contiene il TaskStatus.Canceled valore per la Task.Status Proprietà.If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

Si applica a

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

Scrive in modo asincrono i byte compressi nel flusso Deflate sottostante dalla matrice di byte specificata.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
Public Overrides Function WriteAsync (array As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parametri

array
Byte[]

Buffer contenente i dati da comprimere.The buffer that contains the data to compress.

offset
Int32

Offset dei byte in base zero in array da cui iniziare la copia dei byte nel flusso Deflate.The zero-based byte offset in array from which to begin copying bytes to the Deflate stream.

count
Int32

Numero massimo di byte da scrivere.The maximum number of bytes to write.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.The token to monitor for cancellation requests. Il valore predefinito è None.The default value is None.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

Commenti

Il WriteAsync metodo consente di eseguire operazioni di i/O a elevato utilizzo di risorse senza bloccare il thread principale.The WriteAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Questa considerazione sulle prestazioni è particolarmente importante in un'app di Windows 8. x Store o in un'app desktop in cui un'operazione di flusso che richiede molto tempo può bloccare il thread dell'interfaccia utente e fare in modo che l'app appaia come se non fosse funzionante.This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. I metodi asincroni vengono usati insieme alle async await parole chiave e in Visual Basic e C#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura.Use the CanWrite property to determine whether the current instance supports writing.

Se l'operazione viene annullata prima del completamento, l'attività restituita contiene il TaskStatus.Canceled valore per la Task.Status Proprietà.If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

Si applica a