Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Stream.CopyToAsync (Stream, Int32, CancellationToken)

.NET Framework (current version)
 

Publicado: octubre de 2016

Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, utilizando el tamaño de búfer y el token de cancelación especificados.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

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

Parámetros

destination
Type: System.IO.Stream

Secuencia en la que se copiará el contenido de la secuencia actual.

bufferSize
Type: System.Int32

Tamaño del búfer en bytes. Este valor debe ser mayor que cero. El tamaño predeterminado es 81920.

cancellationToken
Type: System.Threading.CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Valor devuelto

Type: System.Threading.Tasks.Task

Tarea que representa la operación de copia asincrónica.

Exception Condition
ArgumentNullException

El valor de destination es null.

ArgumentOutOfRangeException

buffersize es un valor negativo o es cero.

ObjectDisposedException

Se ha eliminado la secuencia actual o la secuencia de destino.

NotSupportedException

La secuencia actual admite lectura o la secuencia de destino no admite la escritura.

El CopyToAsync método le permite realizar operaciones de E/S de gran cantidad de recursos sin bloquear el subproceso principal. Esta consideración de rendimiento es especialmente importante en una aplicación de la Tienda Windows 8.x o una aplicación de escritorio en que una operación de streaming prolongada puede bloquear el subproceso de interfaz de usuario y hacer que parezca que una aplicación ha dejado de responder. Los métodos asincrónicos se utilizan junto con el async y await palabras clave en Visual Basic y C#.

Si se cancela la operación antes de que finalice, la tarea devuelta contiene la Canceled valor para el Status propiedad.

La copia empieza en la posición actual en la secuencia actual.

Para obtener un ejemplo de copiar datos entre dos secuencias, consulte el CopyToAsync(Stream) de sobrecarga.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 4.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Windows Phone Silverlight
Disponible desde 8.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: