Encoding.Preamble Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas de substitution dans une classe dérivée, retourne une étendue contenant la séquence d’octets qui spécifie l’encodage utilisé.
public:
virtual property ReadOnlySpan<System::Byte> Preamble { ReadOnlySpan<System::Byte> get(); };
public virtual ReadOnlySpan<byte> Preamble { get; }
member this.Preamble : ReadOnlySpan<byte>
Public Overridable ReadOnly Property Preamble As ReadOnlySpan(Of Byte)
Valeur de propriété
Étendue d’octets contenant une séquence d’octets qui spécifie l’encodage utilisé, ou une étendue de longueur zéro, si un préambule n’est pas requis.
Remarques
Si vous le souhaitez, l’objet Encoding fournit un préambule qui est une séquence d’octets pouvant être précédés des octets résultant du processus d’encodage. Si le préambule contient une marque d’ordre d’octet (en Unicode, point de code U+FEFF), il 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) :
UTF-8 : EF BB BF
UTF-16 big endian byte order : FE FF
UTF-16 little endian byte order : FF FE
UTF-32 big endian byte order : 00 00 FE FF
UTF-32 little endian byte order : FF FE 00 00
Vous devez utiliser le boM, car il fournit presque certaines identification d’un encodage pour les fichiers qui ont autrement perdu la référence à l’objet Encoding , par exemple, des données web non étiquetées ou incorrectement é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 correctement étiquetées, de préférence dans UTF-8 ou UTF-16.
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. Malgré les quelques inconvénients, cependant, 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.
Avertissement
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. Toutefois, la plupart des encodages ne fournissent pas de préambule. Pour vous assurer que les octets encodés sont décodés correctement, vous devez utiliser un encodage Unicode, autrement dit, UTF8Encoding, UnicodeEncodingou UTF32Encoding, avec un préambule.