Base64.EncodeToUtf8 Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zakóduje rozsah binárních dat do textu kódování UTF-8 reprezentovaného jako základ 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>
Vstupní rozsah obsahující binární data, která je potřeba zakódovat.
Výstupní rozsah, který obsahuje výsledek operace, to znamená text kódovaný UTF-8 v základu 64.
- bytesConsumed
- Int32
Když tato metoda vrátí hodnotu , obsahuje počet vstupních bajtů spotřebovaných během operace. V případě potřeby se dá použít k průřezu vstupu pro následná volání.
- bytesWritten
- Int32
Když tato metoda vrátí, obsahuje počet bajtů zapsaných do výstupního rozsahu. V případě potřeby se dá použít k průřezu výstupu pro následná volání.
- isFinalBlock
- Boolean
true
(výchozí hodnota) označuje, že vstupní rozsah obsahuje celá data ke kódování. false
k označení, že vstupní rozsah obsahuje částečná data a další data se mají sledovat.
Návraty
Jedna z hodnot výčtu, která označuje stav operace kódování.
Poznámky
Vrácená hodnota může být následující:
- OperationStatus.Done: Zpracování celého vstupního rozsahu bylo úspěšné.
- OperationStatus.DestinationTooSmall: Ve výstupním rozsahu není dostatek místa pro zakódovaný vstup.
- OperationStatus.NeedMoreData:
isFinalBlock
jefalse
.isFinalBlock
V opačném případě setrue
výstup vysunou, pokud vstup není násobek čísla 3.
Tato metoda nemůže vrátit OperationStatus.InvalidData , protože to není možné pro kódování Base-64.