Stream.CopyToAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
Sobrecargas
| Name | Description |
|---|---|
| CopyToAsync(Stream, Int32, CancellationToken) |
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado e um token de cancelamento. As posições de ambos os fluxos são avançadas pelo número de bytes copiados. |
| CopyToAsync(Stream, CancellationToken) |
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um token de cancelamento especificado. As posições de ambos os fluxos são avançadas pelo número de bytes copiados. |
| CopyToAsync(Stream) |
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo número de bytes copiados. |
| CopyToAsync(Stream, Int32) |
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado. As posições de ambos os fluxos são avançadas pelo número de bytes copiados. |
CopyToAsync(Stream, Int32, CancellationToken)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado e um token de cancelamento. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
public:
virtual System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);abstract member CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As TaskParâmetros
- destination
- Stream
O fluxo para o qual o conteúdo do fluxo atual será copiado.
- bufferSize
- Int32
O tamanho, em bytes, do buffer. Este valor deve ser maior que zero. O tamanho padrão é 81920.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de cópia assíncrona.
- Atributos
Exceções
destination é null.
bufferSize é negativo ou zero.
Ou o fluxo atual ou o fluxo de destino é eliminado.
O fluxo atual não suporta leitura, ou o fluxo de destino não suporta escrita.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O CopyToAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Essa consideração de desempenho é particularmente importante em um aplicativo da Windows Store 8.x ou aplicativo da área de trabalho, onde uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que seu aplicativo pareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
Se a operação for cancelada antes de ser concluída, a tarefa devolvida contém o Canceled valor da Status propriedade.
A cópia começa na posição atual no fluxo atual.
Para um exemplo de cópia entre dois fluxos, veja a CopyToAsync(Stream) sobrecarga.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por CopyTo(Stream, Int32).
Aplica-se a
CopyToAsync(Stream, CancellationToken)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um token de cancelamento especificado. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
public:
System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, System.Threading.CancellationToken cancellationToken);member this.CopyToAsync : System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function CopyToAsync (destination As Stream, cancellationToken As CancellationToken) As TaskParâmetros
- destination
- Stream
O fluxo para o qual o conteúdo do fluxo atual será copiado.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de cópia assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O CopyToAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Essa consideração de desempenho é particularmente importante em um aplicativo da Windows Store 8.x ou aplicativo da área de trabalho, onde uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que seu aplicativo pareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
Se a operação for cancelada antes de ser concluída, a tarefa devolvida contém o Canceled valor da Status propriedade.
A cópia começa na posição atual no fluxo atual.
Para um exemplo de cópia entre dois fluxos, veja a CopyToAsync(Stream) sobrecarga.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por CopyTo(Stream).
Aplica-se a
CopyToAsync(Stream)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
public:
System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination);public System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination);member this.CopyToAsync : System.IO.Stream -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CopyToAsync : System.IO.Stream -> System.Threading.Tasks.TaskPublic Function CopyToAsync (destination As Stream) As TaskParâmetros
- destination
- Stream
O fluxo para o qual o conteúdo do fluxo atual será copiado.
Devoluções
Uma tarefa que representa a operação de cópia assíncrona.
- Atributos
Exceções
destination é null.
Ou o fluxo atual ou o fluxo de destino é eliminado.
O fluxo atual não suporta leitura, ou o fluxo de destino não suporta escrita.
Exemplos
O exemplo seguinte demonstra como usar dois FileStream objetos para copiar assíncronamente os ficheiros de um diretório para outro. A FileStream classe deriva da Stream classe. Note que o Click gestor de eventos do Button controlo está marcado com o async modificador porque chama um método assíncrono
using System;
using System.Threading.Tasks;
using System.Windows;
using System.IO;
namespace WpfApplication
{
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private async void Button_Click(object sender, RoutedEventArgs e)
{
string StartDirectory = @"c:\Users\exampleuser\start";
string EndDirectory = @"c:\Users\exampleuser\end";
foreach (string filename in Directory.EnumerateFiles(StartDirectory))
{
using (FileStream SourceStream = File.Open(filename, FileMode.Open))
{
using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
{
await SourceStream.CopyToAsync(DestinationStream);
}
}
}
}
}
}
Imports System.IO
Class MainWindow
Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
Dim StartDirectory As String = "c:\Users\exampleuser\start"
Dim EndDirectory As String = "c:\Users\exampleuser\end"
For Each filename As String In Directory.EnumerateFiles(StartDirectory)
Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
Await SourceStream.CopyToAsync(DestinationStream)
End Using
End Using
Next
End Sub
End Class
Observações
O CopyToAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Essa consideração de desempenho é particularmente importante em um aplicativo da Windows Store 8.x ou aplicativo da área de trabalho, onde uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que seu aplicativo pareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
A cópia começa na posição atual no fluxo atual.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por CopyTo(Stream).
Aplica-se a
CopyToAsync(Stream, Int32)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Lê assíncronamente os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
public:
System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize);public System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, int bufferSize);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, int bufferSize);member this.CopyToAsync : System.IO.Stream * int -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CopyToAsync : System.IO.Stream * int -> System.Threading.Tasks.TaskPublic Function CopyToAsync (destination As Stream, bufferSize As Integer) As TaskParâmetros
- destination
- Stream
O fluxo para o qual o conteúdo do fluxo atual será copiado.
- bufferSize
- Int32
O tamanho, em bytes, do buffer. Este valor deve ser maior que zero. O tamanho padrão é 81920.
Devoluções
Uma tarefa que representa a operação de cópia assíncrona.
- Atributos
Exceções
destination é null.
bufferSize é negativo ou zero.
Ou o fluxo atual ou o fluxo de destino é eliminado.
O fluxo atual não suporta leitura, ou o fluxo de destino não suporta escrita.
Observações
O CopyToAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Essa consideração de desempenho é particularmente importante em um aplicativo da Windows Store 8.x ou aplicativo da área de trabalho, onde uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que seu aplicativo pareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
A cópia começa na posição atual no fluxo atual.
Para um exemplo de cópia entre dois fluxos, veja a CopyToAsync(Stream) sobrecarga.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por CopyTo(Stream, Int32).
