Base64.EncodeToUtf8 Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Buffers.Text

Zestaw:: System.Memory.dll

Zestaw:: netstandard.dll

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.

Koduje zakres danych binarnych do zakodowanego w formacie UTF-8 tekstu reprezentowanego jako podstawowy 64.

public static System.Buffers.OperationStatus EncodeToUtf8 (ReadOnlySpan<byte> bytes, Span<byte> utf8, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);

static member EncodeToUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus

Public Shared Function EncodeToUtf8 (bytes As ReadOnlySpan(Of Byte), utf8 As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus

Parametry

bytes: ReadOnlySpan<Byte>

Zakres danych wejściowych, który zawiera dane binarne, które muszą być zakodowane.

utf8: Span<Byte>

Zakres danych wyjściowych, który zawiera wynik operacji, czyli zakodowany w formacie UTF-8 tekst w bazie 64.

bytesConsumed: Int32

Liczba bajtów wejściowych użytych podczas operacji. Może to służyć do wycinek danych wejściowych dla kolejnych wywołań, jeśli to konieczne.

bytesWritten: Int32

Liczba bajtów zapisanych w zakresie danych wyjściowych. Może to służyć do fragmentowania danych wyjściowych kolejnych wywołań, jeśli to konieczne.

isFinalBlock: Boolean

true (wartość domyślna), jeśli zakres danych wejściowych zawiera całe dane do zakodowania. false jeśli zakres danych wejściowych zawiera częściowe dane z większą ilością danych do naśladowania.

Zwraca

OperationStatus

Jedna z wartości wyliczenia wskazująca stan operacji kodowania.

Uwagi

Wartość zwracana może być następująca:

OperationStatus.Done: Przetwarzanie całego zakresu danych wejściowych zakończyło się pomyślnie.
OperationStatus.DestinationTooSmall: Za mało miejsca w zakresie danych wyjściowych, aby zmieścić zakodowane dane wejściowe.
OperationStatus.NeedMoreData: isFinalBlock to false. W przeciwnym razie, jeśli isFinalBlock wartość to true, dane wyjściowe są dopełniane, jeśli dane wejściowe nie są wielokrotnością 3.

Nie można zwrócić OperationStatus.InvalidData tej metody, ponieważ nie jest to możliwe dla kodowania base-64.

Dotyczy