UTF32Encoding.Preamble Egenskap

Definition

Hämtar ett Unicode-byteordningsmärke som är kodat i UTF-32-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. annars ett standardintervall.

Kommentarer

Objektet UTF32Encoding kan ange en ingress, vilket är ett intervall med byte som kan prefixeras till sekvensen med byte som följer av kodningsprocessen. Genom att föregå en sekvens med kodade byte med ett byteordningsmärke (kodpunkter U+0000U+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: 00 00 FE FF

  • Lite endiansk byteordning: FF FE 00 00

Du kan instansiera ett UTF32Encoding objekt vars Preamble egenskap ä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 objektet, till UTF32Encoding exempel otaggade eller felaktigt taggade webbdata, eller slumpmässiga textfiler som lagras när ett företag inte har internationella problem eller andra data. 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.

Mer information om byteordning och byteordningsmarkering finns i Unicode Standard på Unicode-startsidan.

Important

För att säkerställa att de kodade byteen avkodas korrekt bör du prefixkodade byte med 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