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 étendue de longueur zéro, si aucun préambule n'est requis.
Remarques
L' Encoding objet fournit éventuellement un préambule qui est une séquence d’octets qui peut être préfixée sur les octets résultant du processus d’encodage. Si le préambule contient une marque d’ordre d’octet (au format Unicode, point de code U + FEFF), il permet au décodeur de 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 (au format hexadécimal) :
UTF-8 : EF BB BF
Ordre d’octet UTF-16 Big endian : FE FF
UTF-16 Little endian, ordre des octets : FF FE
UTF-32 Big endian, ordre d’octet : 00 00 FE FF
UTF-32 Little endian, ordre des octets : FF FE 00 00
Vous devez utiliser la marque de nomenclature, car elle fournit quasiment certaines informations d’identification d’un encodage pour les fichiers qui, autrement, ont perdu la référence à l' Encoding objet, par exemple, les données Web non marquées ou mal référencé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 des utilisateurs peuvent être évités si les données sont régulièrement et correctement étiquetées, de préférence en UTF-8 ou UTF-16.
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.
Attention
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. 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,, UTF8EncodingUnicodeEncoding ou UTF32Encoding , avec un préambule.
