WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen