Aracılığıyla paylaş


FileStream.CopyToAsync(Stream, Int32, CancellationToken) Yöntem

Tanım

Geçerli dosya akışındaki baytları zaman uyumsuz olarak okur ve belirtilen arabellek boyutunu ve iptal belirtecini kullanarak başka bir akışa yazar.

public:
 override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

Parametreler

destination
Stream

Geçerli dosya akışının içeriğinin kopyalandığı akış.

bufferSize
Int32

Arabelleğin bayt cinsinden boyutu. Bu değer sıfırdan büyük olmalıdır. Varsayılan boyut 81920'dir.

cancellationToken
CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

Zaman uyumsuz kopyalama işlemini temsil eden görev.

Özel durumlar

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

yöntemi, CopyToAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanızın çalışmıyormuş gibi görünmesini sağlayabildiği bir Windows 8.x Store uygulamasında veya masaüstü uygulamasında bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.

İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledTask.Status değerini içerir.

Kopyalama, geçerli dosya akışındaki geçerli konumda başlar.

İki akış arasında kopyalama örneği için bkz CopyToAsync(Stream) . aşırı yükleme.

Şunlara uygulanır