UTF32Encoding.Preamble Vlastnost

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Zdroj:

UTF32Encoding.cs

Získá znak pořadí bajtů Unicode kódovaný ve formátu UTF-32, pokud je tento objekt nakonfigurován tak, aby jeden.

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)

Hodnota vlastnosti

ReadOnlySpan<Byte>

Bajtové rozpětí obsahující značku pořadí bajtů Unicode, pokud je tento objekt nakonfigurován tak, aby jeden; v opačném případě je výchozí rozsah.

Poznámky

Objekt UTF32Encoding může poskytnout preambuli, což je rozsah bajtů, který může být předponou posloupnosti bajtů vyplývajících z procesu kódování. Prefacing sekvence kódovaných bajtů se značkou pořadí bajtů (body kódu U+0000U+FEFF) pomáhá dekodéru určit pořadí bajtů a formát transformace nebo UTF. Znak pořadí bajtů Unicode (BOM) je serializován následujícím způsobem (v šestnáctkové soustavě):

• Pořadí velkých bajtů: 00 00 FE FF

• Malé pořadí bajtů: FF FE 00 00

Instanci objektu UTF32Encoding, jehož Preamble vlastnost je platným kusovníkem, můžete vytvořit instanci následujícím způsobem:

• Načtením objektu UTF32Encoding vráceného vlastností Encoding.UTF32.

• Voláním konstruktoru bez parametrů UTF32Encoding() vytvořit instanci objektu UTF32Encoding.

• Zadáním true jako hodnoty argumentu byteOrderMark konstruktory UTF32Encoding a UTF32Encoding.

Doporučujeme použít kusovník, protože poskytuje téměř určitou identifikaci kódování souborů, které jinak ztratily odkaz na objekt UTF32Encoding, například neoznačené nebo nesprávně označené webové data nebo náhodné textové soubory uložené v případě, že firma neměla mezinárodní obavy nebo jiná data. Problémy uživatelů se často můžou vyhnout, pokud jsou data konzistentně a správně označená.

Pro standardy, které poskytují typ kódování, je kusovník poněkud redundantní. Dá se ale použít k tomu, aby server posílal správnou hlavičku kódování. Alternativně se dá použít jako záložní v případě, že se kódování jinak ztratí.

Používání kusovníku má určité nevýhody. Například znalost omezení databázových polí, která používají kusovník, může být obtížné. Zřetězení souborů může být také problém, například když se soubory sloučí tak, aby nepotřebný znak mohl skončit uprostřed dat. I přes několik nevýhod se však důrazně doporučuje použití kusovníku.

Další informace o pořadí bajtů a znaku pořadí bajtů naleznete v kódu Unicode Standard na domovské stránce Unicode.

Důležitý

Chcete-li zajistit, aby kódované bajty byly dekódovány správně, měli byste předkódovat bajty s preambuli. Všimněte si, že metoda GetBytes nepředá kusovník do sekvence kódovaných bajtů; poskytování kusovníku na začátku příslušného bajtového datového proudu je odpovědností vývojáře.