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 zakó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ý rozsah obsahující znak pořadí bajtů Unicode, pokud je tento objekt nakonfigurován tak, aby jeden; v opačném případě 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í. Prefekce posloupnosti zakódovaných bajtů se značkou pořadí bajtů (body U+0000U+FEFFkódu) pomáhá dekodéru určit pořadí bajtů a formát transformace neboli UTF. Značka pořadí bajtů unicode (BOM) je serializována následujícím způsobem (v šestnáctkovém formátu):

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

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

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

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

• Voláním konstruktoru bez UTF32Encoding() parametrů k vytvoření instance objektu UTF32Encoding .

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

Doporučujeme použít kusovník, protože poskytuje téměř určitou identifikaci kódování pro soubory, které jinak ztratily odkaz na UTF32Encoding objekt, například neoznačovaná nebo nesprávně označená webová data nebo náhodné textové soubory uložené v případě, že firma neměla mezinárodní záležitosti nebo jiná data. Často se můžete problémům uživatelů 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 odeslal správnou hlavičku kódování. Případně se dá použít jako záložní v případě, že by se kódování jinak ztratilo.

Použití 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 při sloučení souborů takovým způsobem, že nepotřebný znak může 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ů najdete v tématu Standard Unicode na domovské stránce sady Unicode.

Důležité

Abyste zajistili správné dekódování zakódovaných bajtů, měli byste předpony zakódované bajty použít preambuli. Všimněte si, že GetBytes metoda nepředkládá kusovník na sekvenci zakódovaných bajtů. Za poskytnutí kusovníku na začátku příslušného bajtového datového proudu zodpovídá vývojář.