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 den Bereich der binären Daten in UTF-8-codierten Text in Base64-Darstellung.
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>
Der Eingabebereich, der Binärdaten enthält, die codiert werden müssen.
Der Ausgabebereich, der das Ergebnis des Vorgangs enthält, d.h. den UTF-8-codierten Text in Base64-Darstellung.
- bytesConsumed
- Int32
Wenn diese Methode zurückgibt, enthält die Anzahl der Eingabebytes, die während des Vorgangs verbraucht wurden. Dies kann verwendet werden, um die Eingabe ggf. für nachfolgende Aufrufe zu unterteilen.
- bytesWritten
- Int32
Wenn diese Methode zurückgibt, enthält die Anzahl der Bytes, die in die Ausgabespanne geschrieben wurden. Dies kann verwendet werden, um die Ausgabe ggf. für nachfolgende Aufrufe zu unterteilen.
- isFinalBlock
- Boolean
true (Standard), um anzugeben, dass die Eingabespanne die gesamten zu codierenden Daten enthält. false , um anzugeben, dass die Eingabespanne partielle Daten enthält, deren Weitere Daten folgen sollen.
Gibt zurück
Einer der Enumerationswerte, der den Status der Codierung anzeigt.
Hinweise
Der Rückgabewert kann wie folgt aussehen:
- OperationStatus.Done: Die Verarbeitung der gesamten Eingabespanne war erfolgreich.
- OperationStatus.DestinationTooSmall: Es ist nicht genügend Speicherplatz in der Ausgabespanne vorhanden, um die codierte Eingabe zu passen.
- OperationStatus.NeedMoreData:
isFinalBlockistfalse. AndernfallsisFinalBlockwirdtruedie Ausgabe gepolstert, wenn 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.
