CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) Metod

Definition

Läser asynkront byte från den underliggande strömmen, tillämpar relevanta kryptografiska transformeringar och skriver resultatet till målströmmen.

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

Parametrar

destination
Stream

Den ström som innehållet i den aktuella strömmen ska kopieras till.

bufferSize
Int32

Buffertens storlek i byte. Det här värdet måste vara större än noll. Standardstorleken är 81920.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.

Returer

En uppgift som representerar den asynkrona kopieringsåtgärden.

Undantag

destination är null.

bufferSize är negativ eller noll.

Antingen tas den aktuella strömmen eller målströmmen bort.

Den aktuella strömmen stöder inte läsning eller så stöder inte målströmmen skrivning.

Ett fel uppstod under en kryptografisk åtgärd.

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Kopieringen börjar vid den aktuella positionen i den aktuella strömmen och återställer inte målströmmens position när kopieringsåtgärden har slutförts.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av CopyTo(Stream, Int32).

Gäller för