Base64.EncodeToUtf8 Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Codiert die Spanne von Binärdaten in UTF-8-codierten Text, der als Base64 dargestellt wird.
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.OperationStatusPublic 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 OperationStatusParameter
- bytes
- ReadOnlySpan<Byte>
Die Eingabespanne, die Binärdaten enthält, die codiert werden müssen.
Die Ausgabespanne, die das Ergebnis des Vorgangs enthält, d. h. den UTF-8-codierten Text in Base 64.
- bytesConsumed
- Int32
Wenn diese Methode zurückgegeben wird, enthält sie die Anzahl der während des Vorgangs verbrauchten Eingabebytes. Dies kann verwendet werden, um die Eingabe für nachfolgende Aufrufe zu segmentieren, falls erforderlich.
- bytesWritten
- Int32
Wenn diese Methode zurückgegeben wird, enthält die Anzahl der Bytes, die in die Ausgabespanne geschrieben wurden. Dies kann verwendet werden, um die Ausgabe für nachfolgende Aufrufe zu segmentieren, falls erforderlich.
- isFinalBlock
- Boolean
true (Standardeinstellung) um anzugeben, dass die Eingabespanne die gesamten zu codierenden Daten enthält.
false um anzugeben, dass die Eingabespanne Teildaten mit weiteren zu verfolgenden Daten enthält.
Gibt zurück
Einer der Enumerationswerte, der den Status des Codierungsvorgangs angibt.
Hinweise
Der Rückgabewert kann wie folgt sein:
- OperationStatus.Done: Die Verarbeitung der gesamten Eingabespanne war erfolgreich.
- OperationStatus.DestinationTooSmall: Es ist nicht genügend Platz in der Ausgabespanne vorhanden, um die codierte Eingabe anzupassen.
-
OperationStatus.NeedMoreData:
isFinalBlockistfalse. Andernfalls wirdtruedie Ausgabe aufgefüllt,isFinalBlockwenn die Eingabe kein Vielfaches von 3 ist.
Diese Methode kann nicht zurückgegeben werden OperationStatus.InvalidData , da dies für die Base64-Codierung nicht möglich ist.