CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie odczytuje bajty ze strumienia bazowego, stosuje odpowiednie przekształcenia kryptograficzne i zapisuje wynik do strumienia docelowego.
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
Parametry
- destination
- Stream
Strumień, do którego zostanie skopiowana zawartość bieżącego strumienia.
- bufferSize
- Int32
Rozmiar buforu w bajtach. Ta wartość musi być większa niż zero. Domyślny rozmiar to 81920.
- cancellationToken
- CancellationToken
Token do monitorowania żądań anulowania. Wartość domyślna to None.
Zwraca
Zadanie reprezentujące operację kopiowania asynchronicznego.
Wyjątki
destination
to null
.
buffersize
jest ujemna lub zero.
Bieżący strumień lub docelowy strumień jest usuwany.
Bieżący strumień nie obsługuje odczytu lub strumień docelowy nie obsługuje zapisu.
Wystąpił błąd podczas operacji kryptograficznych.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Kopiowanie rozpoczyna się od bieżącego położenia w bieżącym strumieniu i nie resetuje położenia strumienia docelowego po zakończeniu operacji kopiowania.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez CopyTo(Stream, Int32)usługę .