UTF32Encoding.Preamble Propriété

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, 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 U+0000U+FEFFde code) 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’octet petit endian : FF FE 00 00

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

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

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

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

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 des données web non étiquetées ou mal étiquetées, ou des 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 sur 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 GetBytes méthode ne prépendait pas un boM à une séquence d’octets encodés ; l’approvisionnement d’un boM au début d’un flux d’octets approprié est la responsabilité du développeur.