CryptoStream.WriteAsync Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestawy:

netstandard.dll, System.Security.Cryptography.dll

Przeciążenia

WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zapisuje sekwencję bajtów do bieżącego strumienia asynchronicznie, przechodzi bieżącą pozycję w strumieniu według liczby zapisanych bajtów i monitoruje żądania anulowania.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Asynchronicznie zapisuje sekwencję bajtów do bieżącego strumienia, przechodzi bieżącą pozycję w tym strumieniu przez liczbę zapisanych bajtów i monitoruje żądania anulowania.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Źródło:

CryptoStream.cs

Zapisuje sekwencję bajtów do bieżącego strumienia asynchronicznie, przechodzi bieżącą pozycję w strumieniu według liczby zapisanych bajtów i monitoruje żądania anulowania.

C#

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

Parametry

buffer

Byte[]

Bufor do zapisywania danych z.

offset

Int32

Przesunięcie bajtów na podstawie zera, buffer od którego rozpoczyna się zapisywanie bajtów w strumieniu.

count

Int32

Maksymalna liczba bajtów do zapisu.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

ArgumentNullException

buffer to null.

ArgumentOutOfRangeException

offset lub count jest ujemny.

ArgumentException

Suma offset wartości i count jest większa niż długość buforu.

NotSupportedException

Strumień nie obsługuje zapisywania.

ObjectDisposedException

Strumień został usunięty.

InvalidOperationException

Strumień jest obecnie używany przez poprzednią operację zapisu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Musisz wstępnie poprzeć wywołanie metody WriteAsync za pomocą await operatora (C#) lub Await (Visual Basic), aby wstrzymać wykonywanie metody do czasu ukończenia zadania. Aby uzyskać więcej informacji, zobacz Programowanie asynchroniczne (C#) lub Programowanie asynchroniczne przy użyciu Async and Await (Visual Basic).

Jeśli operacja zostanie anulowana przed jej zakończeniem, zwrócone zadanie zawiera Canceled wartość właściwości Status .

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 Write(Byte[], Int32, Int32)usługę .

Zobacz też

• Anulowanie

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Źródło:

CryptoStream.cs

Asynchronicznie zapisuje sekwencję bajtów do bieżącego strumienia, przechodzi bieżącą pozycję w tym strumieniu przez liczbę zapisanych bajtów i monitoruje żądania anulowania.

C#

public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

Parametry

buffer

ReadOnlyMemory<Byte>

Region pamięci do zapisywania danych.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

ValueTask

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

NotSupportedException

Obiekt CryptoStreamMode skojarzony z bieżącym CryptoStream obiektem nie jest zgodny ze strumieniem bazowym. Na przykład ten wyjątek jest zgłaszany podczas korzystania Write z bazowego strumienia, który jest tylko do odczytu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.