UTF32Encoding.Preamble Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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 FFLite endiansk byteordning:
FF FE 00 00
Du kan instansiera ett UTF32Encoding objekt vars Preamble egenskap är en giltig strukturlista på följande sätt:
Genom att hämta objektet UTF32Encoding som returneras av Encoding.UTF32 egenskapen.
Genom att anropa den parameterlösa UTF32Encoding() konstruktorn för att instansiera ett UTF32Encoding objekt.
Genom att
trueange som värdet förbyteOrderMarkargumentet till konstruktorerna UTF32Encoding och UTF32Encoding .
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.