DeflateStream.CopyToAsync(Stream, Int32, CancellationToken) Metodo

Definizione

Legge in modo asincrono tutti i byte dal flusso Deflate corrente e li scrive in un altro flusso, usando una dimensione di buffer specificata.Asynchronously reads the bytes from the current Deflate stream and writes them to another stream, using a specified buffer size.

public:
 override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

Parametri

destination
Stream

Flusso in cui verrà copiato il contenuto del flusso Deflate corrente.The stream to which the contents of the current Deflate stream will be copied.

bufferSize
Int32

Dimensione del buffer, in byte.The size, in bytes, of the buffer. Il valore deve essere maggiore di zero.This value must be greater than zero. La dimensione predefinita è 81920.The default size is 81920.

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 copia asincrona.A task that represents the asynchronous copy operation.

Commenti

Il CopyToAsync metodo consente di eseguire operazioni di i/O a elevato utilizzo di risorse senza bloccare il thread principale.The CopyToAsync 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#.

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.

La copia inizia in corrispondenza della posizione corrente nel flusso deflate corrente.Copying begins at the current position in the current Deflate stream.

Si applica a