UTF32Encoding.Preamble Vlastnost

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, 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 zakódovaných bajtů pomocí znaku pořadí bajtů (body U+0000U+FEFFkódu) 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ě):

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

• Malé endian bajtové pořadí: FF FE 00 00

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

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

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

• true Zadáním hodnoty argumentu byteOrderMark konstruktorůmUTF32Encoding.UTF32Encoding

Doporučujeme použít kusovník, protože poskytuje téměř určitou identifikaci kódování souborů, které jinak ztratily odkaz na UTF32Encoding objekt, 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 značce pořadí bajtů naleznete v tématu Standard Unicode 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 GetBytes metoda nepředkládá kusovník na sekvenci kódovaných bajtů; poskytnutí kusovníku na začátku příslušného bajtového streamu je zodpovědností vývojáře.