Encoding.Preamble Eigenschap

Definitie

Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een bereik met de reeks bytes die de gebruikte codering aangeeft.

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)

Waarde van eigenschap

Een bytespanne die een reeks bytes bevat die de gebruikte codering aangeeft, of een lengte nul, als een preambule niet vereist is.

Opmerkingen

Optioneel biedt het Encoding object een preparate die een reeks bytes is die kan worden voorafgegaan door de bytes die het gevolg zijn van het coderingsproces. Als de preambule een bytevolgordemarkering bevat (in Unicode, codepunt U+FEFF), helpt de decoder de bytevolgorde en de transformatieindeling of UTF te bepalen.

De Unicode byte order mark (BOM) wordt als volgt geserialiseerd (in hexadecimaal):

  • UTF-8: EF BB BF

  • UTF-16 big endian byte order: FE FF

  • UTF-16 kleine endiane bytevolgorde: FF FE

  • UTF-32 big endian byte order: 00 00 FE FF

  • UTF-32 little endian byte order: FF FE 00 00

U moet de stuklijst gebruiken, omdat deze bijna bepaalde identificatie biedt van een codering voor bestanden die anders zijn verloren gegaan naar het Encoding object, bijvoorbeeld zonder vlag of onjuist gelabelde webgegevens of willekeurige tekstbestanden die zijn opgeslagen wanneer een bedrijf geen internationale problemen of andere gegevens had. Vaak worden gebruikersproblemen vermeden als gegevens consistent en correct zijn gelabeld, bij voorkeur in UTF-8 of UTF-16.

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.

Voor meer informatie over bytevolgorde en het byte-ordemerk, zie de Unicode-standaard op de Unicode-startpagina.

Caution

Om ervoor te zorgen dat de gecodeerde bytes correct worden gedecodeerd, moet u voorgecodeerde bytes met een preparateer. De meeste coderingen bieden echter geen preambule. Om ervoor te zorgen dat de gecodeerde bytes correct worden gedecodeerd, moet u een Unicode-codering, dat wil gezegd, UTF8Encoding, UnicodeEncodingof UTF32Encoding, met een pretaat gebruiken.

Van toepassing op