Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Encoder de l’ASCII dans un tampon Span<byte>

Utilisez Encoding.ASCII pour encoder un ReadOnlySpan<char> dans un tampon Span<byte>. GetByteCount calcule la taille nécessaire, tandis que GetBytes écrit les octets et renvoie leur nombre. Le remplacement par défaut des caractères non ASCII peut entraîner une perte de données.

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

Syntaxe

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, dans l’espace de noms System.Text, encode le jeu de caractères ASCII sur 7 bits, de U+0000 à U+007F. Il ne permet pas d’encoder du texte Unicode quelconque : le mécanisme de repli par défaut remplace les caractères impossibles à encoder par ? (octet 0x3F). Il ne translittère donc pas é en e et ne convient pas à une validation ASCII stricte.

Encoding.GetByteCount(ReadOnlySpan<char>) calcule le nombre exact d’octets pour l’entrée et le mécanisme de repli configuré, sans écrire de données. Encoding.GetBytes(ReadOnlySpan<char>, Span<byte>) encode dans un tampon fourni par l’appelant et renvoie le nombre d’octets écrits. Contrairement à la surcharge GetBytes(string), cette méthode ne renvoie pas un nouveau byte[].

Le tampon de destination doit avoir au moins la capacité calculée ; s’il est trop petit, une ArgumentException est levée. Calculez la taille et encodez avec le même encodage et une entrée inchangée. Ne transmettez ensuite que buffer[..written], et non toute la capacité du tampon. Le tampon stackalloc de taille fixe de l’exemple suffit pour sa courte entrée ; ne faites pas dépendre une allocation de pile illimitée de la taille de données externes.

L’exemple utilise des surcharges avec des spans disponibles dans .NET 10 et ne nécessite pas de syntaxe en préversion. Hi é produit quatre octets, 48 69 20 3F, ce qui illustre la perte de é. Si une perte de données est inacceptable, configurez l’encodage ASCII avec EncoderFallback.ExceptionFallback ; si le format autorise Unicode, choisissez un encodage adapté, tel que Encoding.UTF8.

Exemples

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

Résultat

Required: 4; written: 4
4869203F

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources