UnicodeEncoding.Preamble Eigenschaft

Definition

Ruft eine Unicode-Bytereihenfolgemarkierung im UTF-16-Format ab, wenn dieses Objekt entsprechend konfiguriert ist.Gets a Unicode byte order mark encoded in UTF-16 format, if this object is configured to supply one.

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)

Eigenschaftswert

Eine Byte Spanne, die die Unicode-Byte Reihenfolge Markierung enthält, wenn dieses Objekt für die Bereitstellung eines solchen konfiguriert ist. andernfalls die Standard Spanne.A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, the default span.

Hinweise

Das UnicodeEncoding -Objekt kann eine Präambel bereitstellen, bei der es sich um eine Byte Spanne handelt, die der Byte Sequenz vorangestellt werden kann, die sich aus dem Codierungsprozess ergibt.The UnicodeEncoding object can provide a preamble, which is a byte span that can be prepended to the sequence of bytes resulting from the encoding process. Wenn eine Sequenz codierter Bytes mit einer Byte Reihenfolge-Markierung ( U+FEFFCodepunkt) vorangestellt ist, kann der Decoder die Byte Reihenfolge und das Transformations Format oder UTF festlegen.Prefacing a sequence of encoded bytes with a byte order mark (code point U+FEFF) helps the decoder determine the byte order and the transformation format or UTF. Die Unicode-Byte Reihenfolge Markierung (BOM) wird wie folgt serialisiert (in Hexadezimal):The Unicode byte order mark (BOM) is serialized as follows (in hexadecimal):

  • Big-Endian-Byte Reihenfolge:FE FFBig endian byte order: FE FF

  • Little-Endian-Byte Reihenfolge:FF FELittle endian byte order: FF FE

Sie können ein UnicodeEncoding -Objekt, dessen Preamble eine gültige BOM ist, auf folgende Weise instanziieren:You can instantiate a UnicodeEncoding object whose Preamble is a valid BOM in the following ways:

Es wird empfohlen, die BOM zu verwenden, da Sie eine bestimmte Identifizierung einer Codierung für Dateien bereitstellt, die andernfalls einen Verweis auf ihre Codierung verloren haben, z. b. nicht markierte oder nicht ordnungsgemäß markierte Webdaten oder Zufalls Textdateien, die gespeichert wurden, wenn ein Unternehmen nicht über internationale Probleme.We recommended that you use the BOM, since it provides nearly certain identification of an encoding for files that otherwise have lost a reference to their encoding, such as untagged or improperly tagged web data or random text files stored when a business did not have international concerns. Häufig können Benutzer Probleme vermieden werden, wenn die Daten konsistent und ordnungsgemäß gekennzeichnet sind.Often user problems might be avoided if data is consistently and properly tagged.

Bei Standards, die einen Codierungstyp bereitstellen, ist eine BOM etwas redundant.For standards that provide an encoding type, a BOM is somewhat redundant. Sie kann jedoch verwendet werden, um einem Server zu helfen, den richtigen Codierungs Header zu senden.However, it can be used to help a server send the correct encoding header. Alternativ kann es als Fall Back für den Fall verwendet werden, dass die Codierung andernfalls verloren geht.Alternatively, it can be used as a fallback in case the encoding is otherwise lost.

Es gibt einige Nachteile bei der Verwendung einer BOM.There are some disadvantages to using a BOM. Beispielsweise kann das Einschränken der Datenbankfelder, die eine BOM verwenden, schwierig sein.For example, knowing how to limit the database fields that use a BOM can be difficult. Die Verkettung von Dateien kann auch ein Problem darstellen, z. b. wenn Dateien so zusammengeführt werden, dass ein unnötiges Zeichen in der Mitte der Daten enden kann.Concatenation of files can be a problem also, for example, when files are merged in such a way that an unnecessary character can end up in the middle of data. Trotz der wenigen Nachteile wird die Verwendung einer BOM dringend empfohlen.In spite of the few disadvantages, however, the use of a BOM is highly recommended.

Wichtig

Um sicherzustellen, dass die codierten Bytes ordnungsgemäß decodiert werden, sollten Sie dem Anfang eines Streams codierter Bytes eine Präambel vorangestellt sein.To ensure that the encoded bytes are decoded properly, you should prefix the beginning of a stream of encoded bytes with a preamble. Beachten Sie, GetBytes dass die-Methode einer Sequenz codierter Bytes keine BOM voranstellt. die Bereitstellung einer BOM am Anfang eines entsprechenden Bytestreams ist die Verantwortung des Entwicklers.Note that the GetBytes method does not prepend a BOM to a sequence of encoded bytes; supplying a BOM at the beginning of an appropriate byte stream is the developer's responsibility.

Gilt für: