Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

.NET Framework 4.5

Lee asincrónicamente todos los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado.

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

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

Parámetros

destination
Tipo: System.IO.Stream
Secuencia en la que se copiará el contenido de la secuencia actual.
bufferSize
Tipo: System.Int32
Tamaño del búfer en bytes. Este valor debe ser mayor que cero. El tamaño predeterminado es 4096.

Valor devuelto

Tipo: System.Threading.Tasks.Task
Tarea que representa la operación de copia asincrónica.

ExcepciónCondición
ArgumentNullException

destination es null.

ArgumentOutOfRangeException

buffersize es un valor negativo o es cero.

ObjectDisposedException

Se desecha la secuencia actual o la secuencia de destino.

NotSupportedException

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

El método CopyToAsync permite realizar operaciones de E/S consumir muchos recursos sin bloquear el subproceso principal. Esta consideración de rendimiento es especialmente importante en una aplicación de Tienda Windows o la aplicación escritorio donde una operación larga de la secuencia puede bloquear el subproceso de interfaz de usuario y que aparece la aplicación como si no funciona. Los métodos de async se usan junto con las palabras clave async y await de Visual Basic y C#.

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

Para obtener un ejemplo de copiar entre dos secuencias, vea la sobrecarga CopyToAsync(Stream) .

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el valor de propiedad Resources siguiente: ExternalThreading. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

.NET Framework

Compatible con: 4.5

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft