CKTIS / C#
ASCII in einen Span<byte>-Puffer codieren
Verwenden Sie Encoding.ASCII, um einen ReadOnlySpan<char> in einen Span<byte>-Puffer zu codieren. GetByteCount berechnet die benötigte Größe, während GetBytes die Bytes schreibt und ihre Anzahl zurückgibt. Die standardmäßige Ersetzung von Nicht-ASCII-Zeichen kann zu Datenverlust führen.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
using System;
using System.Text;
ReadOnlySpan<char> chars = "Hi";
Encoding encoding = Encoding.ASCII;
int required = encoding.GetByteCount(chars);
Span<byte> bytes = new byte[required];
int written = encoding.GetBytes(chars, bytes);Encoding.ASCII im Namespace System.Text codiert den 7-Bit-ASCII-Zeichensatz U+0000–U+007F. Es kann keinen beliebigen Unicode-Text codieren: Der standardmäßige Fallback ersetzt nicht codierbare Zeichen durch ? (Byte 0x3F). Daher wird é nicht in e transliteriert, und die Codierung eignet sich nicht zur strikten ASCII-Validierung.
Encoding.GetByteCount(ReadOnlySpan<char>) berechnet die genaue Byteanzahl für die Eingabe und den konfigurierten Fallback, ohne Daten zu schreiben. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) codiert in einen vom Aufrufer bereitgestellten Puffer und gibt die Anzahl der geschriebenen Bytes zurück. Anders als die Überladung GetBytes(string) gibt sie kein neues byte[] zurück.
Der Zielpuffer muss mindestens die berechnete Kapazität haben; ein zu kleiner Puffer löst ArgumentException aus. Berechnen Sie die Größe und codieren Sie mit derselben Codierung und unveränderter Eingabe. Geben Sie anschließend nur buffer[..written] weiter, nicht die gesamte Pufferkapazität. Der feste stackalloc-Puffer im Beispiel reicht für die kurze Eingabe aus; machen Sie keine unbegrenzte Stack-Allokation von der Größe externer Daten abhängig.
Das Beispiel verwendet in .NET 10 verfügbare Span-Überladungen und benötigt keine Vorschau-Syntax. Hi é ergibt vier Bytes, 48 69 20 3F, wodurch der Verlust von é sichtbar wird. Wenn Datenverlust nicht akzeptabel ist, konfigurieren Sie ASCII mit EncoderFallback.ExceptionFallback; erlaubt das Format Unicode, wählen Sie eine passende Codierung wie Encoding.UTF8.
Beispiele
using System;
using System.Text;
ReadOnlySpan<char> text = "Hi \u00E9".AsSpan();
Encoding encoding = Encoding.ASCII;
int required = encoding.GetByteCount(text);
Span<byte> buffer = stackalloc byte[32];
int written = encoding.GetBytes(text, buffer);
Console.WriteLine($"Required: {required}; written: {written}");
Console.WriteLine(Convert.ToHexString(buffer[..written]));Ergebnis
Required: 4; written: 4 4869203F
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.