UnicodeEncoding.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-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 FFLite endiansk byteordning:
FF FE
Du kan instansiera ett UnicodeEncoding objekt vars Preamble är en giltig strukturlista på följande sätt:
Genom att hämta objektet UnicodeEncoding som returneras av Encoding.Unicode egenskapen eller Encoding.BigEndianUnicode .
Genom att anropa den parameterlösa UnicodeEncoding() konstruktorn för att instansiera ett UnicodeEncoding objekt.
Genom att
trueange som värdet förbyteOrderMarkargumentet till UnicodeEncoding(Boolean, Boolean) konstruktorerna eller UnicodeEncoding(Boolean, Boolean, Boolean) .
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.