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 une.

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’octet 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, c’est-à-dire une étendue d’octets qui peut être précédée de la séquence d’octets résultant du processus d’encodage. Le préfacage d’une séquence d’octets encodés avec une marque d’ordre d’octet (points U+0000U+FEFFde code ) aide le décodeur à déterminer l’ordre d’octets et le format de transformation, ou UTF. La marque d’ordre d’octet Unicode (BOM) est sérialisée comme suit (au format hexadécimal) :

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

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

Vous pouvez instancier un UTF32Encoding objet dont Preamble la propriété est une nomenclature valide des manières suivantes :

• 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 .

Nous vous recommandons d’utiliser la nomenclature, car elle fournit une identification quasi certaine d’un encodage pour les fichiers qui, sinon, ont perdu une référence à l’objet UTF32Encoding , comme des données web non marquées ou mal étiquetées, ou des fichiers texte aléatoires stockés lorsqu’une entreprise n’avait pas de préoccupations internationales ou d’autres données. Souvent, les problèmes utilisateur peuvent être évités si les données sont étiquetées de manière cohérente et correctement.

Pour les normes qui fournissent un type d’encodage, une nomenclature est un 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 au cas où l’encodage serait perdu.

L’utilisation d’une nomenclature présente quelques inconvénients. Par exemple, il peut être difficile de savoir comment limiter les champs de base de données qui utilisent une nomenclature. La concaténation de fichiers peut également être un problème, par exemple, lorsque des fichiers sont fusionnés de manière à ce qu’un caractère inutile puisse se retrouver au milieu des données. Malgré les quelques inconvénients, toutefois, l’utilisation d’une nomenclature 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’hébergement Unicode.

Important

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