UnicodeEncoding.Preamble Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een Unicode byte ordermarkering op die is gecodeerd in UTF-16-indeling, als dit object is geconfigureerd om er een op te geven.
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)Waarde van eigenschap
Een bytespanne met het Unicode-bytevolgordeteken, als dit object is geconfigureerd om er een op te geven; anders is de standaardspanne.
Opmerkingen
Het UnicodeEncoding object kan een preambule bieden, een bytespanne die kan worden voorafgegaan door de reeks bytes die het gevolg zijn van het coderingsproces. Door een reeks gecodeerde bytes vooraf te laten gaan met een bytevolgordemarkering (codepunt U+FEFF) kan de decoder de bytevolgorde en de transformatie-indeling of UTF bepalen. De Unicode byte order mark (BOM) wordt als volgt geserialiseerd (in hexadecimaal):
Big endian bytevolgorde:
FE FFKleine endian bytevolgorde:
FF FE
U kunt op de volgende manieren een exemplaar maken van een UnicodeEncoding object waarvan Preamble het een geldige stuklijst is:
Door het UnicodeEncoding object op te halen dat wordt geretourneerd door de Encoding.Unicode of Encoding.BigEndianUnicode eigenschap.
Door de parameterloze UnicodeEncoding() constructor aan te roepen om een UnicodeEncoding object te instantiëren.
Door op te geven
trueals de waarde van hetbyteOrderMarkargument aan de UnicodeEncoding(Boolean, Boolean) of UnicodeEncoding(Boolean, Boolean, Boolean) constructors.
We raden u aan de bom te gebruiken, omdat het bijna bepaalde identificatie biedt van een codering voor bestanden die anders een verwijzing naar hun codering hebben verloren, zoals niet-gemarkeerde of onjuist gelabelde webgegevens of willekeurige tekstbestanden die zijn opgeslagen wanneer een bedrijf geen internationale zorgen had. Vaak worden gebruikersproblemen vermeden als gegevens consistent en correct zijn gelabeld.
Voor standaarden die een coderingstype bieden, is een stuklijst enigszins redundant. Het kan echter worden gebruikt om een server te helpen de juiste coderingsheader te verzenden. Het kan ook worden gebruikt als een terugval in het geval dat de codering anders verloren gaat.
Er zijn enkele nadelen voor het gebruik van een BOM. Het kan bijvoorbeeld lastig zijn om te weten hoe u de databasevelden kunt beperken die gebruikmaken van een stuklijst. Samenvoeging van bestanden kan ook een probleem zijn, bijvoorbeeld wanneer bestanden zo worden samengevoegd dat een onnodig teken midden in de gegevens terecht kan komen. Ondanks de weinige nadelen wordt het gebruik van een BOM echter ten zeerste aanbevolen.
Important
Om ervoor te zorgen dat de gecodeerde bytes correct worden gedecodeerd, moet u het begin van een stroom gecodeerde bytes met een preparate voorvoegsel geven. Houd er rekening mee dat met de GetBytes methode geen bom wordt voorafgegaan aan een reeks gecodeerde bytes. Het leveren van een bom aan het begin van een geschikte bytestroom is de verantwoordelijkheid van de ontwikkelaar.
