FileStream.CopyToAsync(Stream, Int32, CancellationToken) FileStream.CopyToAsync(Stream, Int32, CancellationToken) FileStream.CopyToAsync(Stream, Int32, CancellationToken) Method

Definizione

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

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

Parametri

destination
Stream Stream Stream

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

bufferSize
Int32 Int32 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 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

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'applicazione Windows 8.x StoreWindows 8.x Store o desktopdesktop in cui tramite un'operazione di flusso per cui è richiesto molto tempo è possibile bloccare il thread UI e far sembrare che l'applicazione non funzioni.This performance consideration is particularly important in a Windows 8.x StoreWindows 8.x Store app or desktopdesktop 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 async alle parole chiave e await 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 TaskStatus.Canceled contiene il valore Task.Status per la 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 di file corrente.Copying begins at the current position in the current file stream.

Per un esempio di copia tra due flussi, vedere l' CopyToAsync(Stream) overload.For an example of copying between two streams, see the CopyToAsync(Stream) overload.

Si applica a