Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Stream.CopyToAsync (Stream, Int32, CancellationToken)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Legge in modo asincrono i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione di buffer specificata e un token di annullamento.

Spazio dei nomi:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public virtual Task CopyToAsync(
	Stream destination,
	int bufferSize,
	CancellationToken cancellationToken
)

Parametri

destination
Type: System.IO.Stream

Flusso in cui verrà copiato il contenuto del flusso corrente.

bufferSize
Type: System.Int32

Dimensione del buffer, in byte. Il valore deve essere maggiore di zero. La dimensione predefinita è 81920.

cancellationToken
Type: System.Threading.CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Valore restituito

Type: System.Threading.Tasks.Task

Attività che rappresenta l'operazione di copia asincrona.

Exception Condition
ArgumentNullException

destination è null.

ArgumentOutOfRangeException

buffersize è un valore negativo o zero.

ObjectDisposedException

Il flusso di destinazione o nel flusso corrente è stato eliminato.

NotSupportedException

Il flusso corrente supporta la lettura o il flusso di destinazione non supporta la scrittura.

Il CopyToAsync metodo consente di eseguire operazioni dei / o di risorse senza bloccare il thread principale. Questa considerazione sulle prestazioni è particolarmente importante in un'applicazione Windows 8.x Store o desktop 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. I metodi asincroni vengono utilizzati in combinazione con il async e await le parole chiave in Visual Basic e c#.

Se l'operazione viene annullata prima del completamento, l'attività restituita contiene il Canceled valore per la Status proprietà.

Inizia la copia nella posizione corrente nel flusso corrente.

Per un esempio di copia tra due flussi, vedere il CopyToAsync(Stream) overload.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 4.5
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Windows Phone Silverlight
Disponibile da 8.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: