Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Codificare ASCII in un buffer Span<byte>

Usa Encoding.ASCII per codificare un ReadOnlySpan<char> in un buffer Span<byte>. GetByteCount calcola la dimensione necessaria, mentre GetBytes scrive i byte e ne restituisce il numero. La sostituzione predefinita dei caratteri non ASCII può causare perdita di dati.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

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, nello spazio dei nomi System.Text, codifica il set di caratteri ASCII a 7 bit, da U+0000 a U+007F. Non può codificare testo Unicode arbitrario: il fallback predefinito sostituisce i caratteri non codificabili con ? (byte 0x3F). Quindi non traslittera é in e e non è adatto alla convalida rigorosa di ASCII.

Encoding.GetByteCount(ReadOnlySpan<char>) calcola il numero esatto di byte per l'input e il fallback configurato, senza scrivere dati. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) codifica in un buffer fornito dal chiamante e restituisce il numero di byte scritti. A differenza dell'overload GetBytes(string), non restituisce un nuovo byte[].

Il buffer di destinazione deve avere almeno la capacità calcolata; se è troppo piccolo, viene generata un'ArgumentException. Calcola la dimensione e codifica usando la stessa codifica e un input invariato. Passa poi solo buffer[..written], non l'intera capacità del buffer. Il buffer stackalloc a dimensione fissa dell'esempio è sufficiente per il breve input; non rendere un'allocazione illimitata sullo stack dipendente dalle dimensioni di dati esterni.

L'esempio usa overload con span disponibili in .NET 10 e non richiede sintassi preview. Hi é produce quattro byte, 48 69 20 3F, mostrando la perdita di é. Se la perdita di dati non è accettabile, configura la codifica ASCII con EncoderFallback.ExceptionFallback; se il formato consente Unicode, scegli una codifica adatta, come Encoding.UTF8.

Esempi

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]));

Risultato

Required: 4; written: 4
4869203F

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti