UTF32Encoding.Preamble Propriété

Définition

Espace de noms:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Source:

UTF32Encoding.cs

Obtient une marque d’ordre d’octet Unicode encodée au format UTF-32, si cet objet est configuré pour en fournir un.

public:
 virtual property ReadOnlySpan<System::Byte> Preamble { ReadOnlySpan<System::Byte> get(); };

public override ReadOnlySpan<byte> Preamble { get; }

member this.Preamble : ReadOnlySpan<byte>

Public Overrides ReadOnly Property Preamble As ReadOnlySpan(Of Byte)

Valeur de propriété

ReadOnlySpan<Byte>

Étendue d’octets contenant la marque d’ordre d’octet Unicode, si cet objet est configuré pour en fournir un ; sinon, une étendue par défaut.

Remarques

L’objet UTF32Encoding peut fournir un préambule, qui est une étendue d’octets qui peut être précédée de la séquence d’octets résultant du processus d’encodage. La précédation d’une séquence d’octets codés avec une marque d’ordre d’octet (points de code U+0000U+FEFF) aide le décodeur à déterminer l’ordre d’octet et le format de transformation, ou UTF. La marque d’ordre d’octet Unicode (BOM) est sérialisée comme suit (en hexadécimal) :

• Ordre d’octets big endian : 00 00 FE FF

• Ordre d’octets little endian : FF FE 00 00

Vous pouvez instancier un objet UTF32Encoding dont la propriété Preamble est un boM valide de la manière suivante :

• En récupérant l’objet UTF32Encoding retourné par la propriété Encoding.UTF32.

• En appelant le constructeur UTF32Encoding() sans paramètre pour instancier un objet UTF32Encoding.

• En fournissant true comme valeur de l’argument byteOrderMark aux constructeurs UTF32Encoding et UTF32Encoding.

Nous vous recommandons d’utiliser le boM, car il fournit presque certaines identifications d’un encodage pour les fichiers qui, sinon, ont perdu une référence à l’objet UTF32Encoding, comme les données web non étiquetées ou mal étiquetées, ou les fichiers texte aléatoires stockés lorsqu’une entreprise n’a pas de préoccupations internationales ou d’autres données. Souvent, les problèmes utilisateur peuvent être évités si les données sont régulièrement et correctement étiquetées.

Pour les normes qui fournissent un type d’encodage, une boM est quelque peu redondante. Toutefois, il peut être utilisé pour aider un serveur à envoyer l’en-tête d’encodage correct. Vous pouvez également l’utiliser comme secours si l’encodage est autrement perdu.

Il existe certains inconvénients à l’utilisation d’un boM. Par exemple, savoir comment limiter les champs de base de données qui utilisent un boM peut être difficile. La concaténation des fichiers peut également être un problème, par exemple, lorsque les fichiers sont fusionnés de telle sorte qu’un caractère inutile peut se retrouver au milieu des données. Toutefois, malgré les quelques inconvénients, l’utilisation d’un boM est fortement recommandée.

Pour plus d’informations sur l’ordre d’octet et la marque d’ordre d’octet, consultez la norme Unicode dans la page d’accueil Unicode.

Important

Pour vous assurer que les octets encodés sont décodés correctement, vous devez préfixer les octets encodés avec un préambule. Notez que la méthode GetBytes ne prépendait pas un boM à une séquence d’octets encodés ; fournir un boM au début d’un flux d’octets approprié est la responsabilité du développeur.