UnicodeEncoding.Preamble Egenskap

Definition

Hämtar ett Unicode-byteordningsmärke som är kodat i UTF-16-format, om det här objektet är konfigurerat för att ange ett.

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)

Egenskapsvärde

Ett byteintervall som innehåller Unicode-byteordningsmarkeringen om det här objektet är konfigurerat för att ange ett. i annat fall standardintervallet.

Kommentarer

Objektet UnicodeEncoding kan ange en ingress, vilket är ett byteintervall som kan förberedas för sekvensen med byte som är resultatet av kodningsprocessen. Genom att föregå en sekvens med kodade byte med ett byteordningsmärke (kodpunkt U+FEFF) kan avkodaren fastställa byteordningen och transformeringsformatet eller UTF. Unicode byte order mark (BOM) serialiseras på följande sätt (i hexadecimal):

  • Stor endiansk byteordning: FE FF

  • Lite endiansk byteordning: FF FE

Du kan instansiera ett UnicodeEncoding objekt vars Preamble är en giltig strukturlista på följande sätt:

Vi rekommenderar att du använder bommen eftersom den ger nästan viss identifiering av en kodning för filer som annars har förlorat en referens till deras kodning, till exempel otaggade eller felaktigt taggade webbdata eller slumpmässiga textfiler som lagras när ett företag inte har internationella problem. Ofta kan användarproblem undvikas om data är konsekventa och korrekt taggade.

För standarder som tillhandahåller en kodningstyp är en strukturliste något redundant. Den kan dock användas för att hjälpa en server att skicka rätt kodningshuvud. Alternativt kan den användas som reserv om kodningen annars går förlorad.

Det finns vissa nackdelar med att använda en strukturlista. Det kan till exempel vara svårt att veta hur databasfälten som använder en strukturlista ska begränsas. Sammanfogning av filer kan vara ett problem, till exempel när filer slås samman på ett sådant sätt att ett onödigt tecken kan hamna mitt i data. Trots de få nackdelarna rekommenderas dock användningen av en strukturlista starkt.

Important

För att säkerställa att de kodade byteen avkodas korrekt bör du prefixa början av en ström med kodade byte med en ingress. Observera att GetBytes metoden inte förbereder en bom till en sekvens med kodade byte. Det är utvecklarens ansvar att tillhandahålla en strukturlista i början av en lämplig byteström.

Gäller för