Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Stream.CopyToAsync (Stream, Int32, CancellationToken)

.NET Framework 4.5

Legge in modo asincrono i byte dal flusso corrente e li scrive in un altro flusso, utilizzando 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
Tipo: System.IO.Stream
Il flusso in cui il contenuto del flusso corrente verrà copiato.
bufferSize
Tipo: System.Int32
La dimensione, in byte, del buffer. Il valore deve essere maggiore di zero. La dimensione predefinita è 4096.
cancellationToken
Tipo: System.Threading.CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Valore restituito

Tipo: System.Threading.Tasks.Task
Attività che rappresenta l'operazione di copia asincrona.

EccezioneCondizione
ArgumentNullException

destination è null.

ArgumentOutOfRangeException

buffersize è un valore negativo o zero.

ObjectDisposedException

Il flusso corrente o il flusso di destinazione viene eliminato.

NotSupportedException

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

Il metodo CopyToAsync consente di eseguire le operazioni di I/O sui file a elevato utilizzo di risorse senza bloccare il thread principale. Questa considerazione delle prestazioni è particolarmente importante in un'applicazione Windows Store o in un'applicazione desktop dove un'operazione dispendiosa in termini di tempo corrente può bloccare il thread UI, mostrando apparentemente un'applicazione non funzionante. I metodi async vengono utilizzati insieme alle parole chiave await e async in Visual Basic e C#.

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

La copia inizia in corrispondenza della posizione corrente del flusso corrente.

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

NotaNota

L'attributo HostProtectionAttribute applicato a questo tipo di membro dispone del seguente valore per la proprietà Resources: ExternalThreading. L'oggetto HostProtectionAttribute non influisce sulle applicazioni desktop, che in genere vengono avviate facendo doppio clic sull'icona, digitando un comando oppure immettendo un URL in un browser. Per ulteriori informazioni, vedere la classe HostProtectionAttribute o programmazione per SQL Server e attributi di protezione host.

.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft