Encoding.Preamble Eigenschaft

Definition

Namespace:

System.Text

Assembly:

System.Runtime.dll

Source:

Encoding.cs

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Bytefolge zurück, die die verwendete Codierung angibt.

public:
 virtual property ReadOnlySpan<System::Byte> Preamble { ReadOnlySpan<System::Byte> get(); };

public virtual ReadOnlySpan<byte> Preamble { get; }

member this.Preamble : ReadOnlySpan<byte>

Public Overridable ReadOnly Property Preamble As ReadOnlySpan(Of Byte)

Eigenschaftswert

ReadOnlySpan<Byte>

Eine Bytespanne mit einer Bytefolge, die die verwendete Codierung angibt, oder eine Spanne der Länge 0 (null), wenn keine Präambel erforderlich ist.

Hinweise

Optional stellt das- Encoding Objekt eine Präambel bereit, bei der es sich um eine Bytefolge handelt, die den aus dem Codierungsprozess resultierenden Bytes vorangestellt werden kann. Wenn die Präambel eine Byte Reihenfolge-Markierung (in Unicode, Codepunkt U + FEFF) enthält, unterstützt Sie der Decoder dabei, die Byte Reihenfolge und das Transformations Format oder UTF zu bestimmen.

Die Unicode-Byte Reihenfolge Markierung (BOM) wird wie folgt serialisiert (in Hexadezimal):

• UTF-8: EF BB BF

• UTF-16 Big-Endian-Byte Reihenfolge: FE FF

• UTF-16 Little-Endian-Byte Reihenfolge: FF FE

• UTF-32 Big Endian-Byte Reihenfolge: 00 00 FE FF

• UTF-32 Little-Endian-Byte Reihenfolge: FF FE 00 00

Sie sollten die BOM verwenden, da Sie fast eine bestimmte Identifizierung einer Codierung für Dateien bereitstellt, die andernfalls den Verweis auf das Objekt verloren haben Encoding , z. b. nicht markierte oder nicht ordnungsgemäß markierte Webdaten oder Zufalls Textdateien, die gespeichert wurden, wenn ein Unternehmen über keine internationalen Probleme oder andere Daten verfügte. Häufig können Benutzer Probleme vermieden werden, wenn die Daten konsistent und ordnungsgemäß gekennzeichnet sind, vorzugsweise in UTF-8 oder UTF-16.

Bei Standards, die einen Codierungstyp bereitstellen, ist eine BOM etwas redundant. Sie kann jedoch verwendet werden, um einem Server zu helfen, den richtigen Codierungs Header zu senden. Alternativ kann es als Fall Back für den Fall verwendet werden, dass die Codierung andernfalls verloren geht.

Es gibt einige Nachteile bei der Verwendung einer BOM. Beispielsweise kann das Einschränken der Datenbankfelder, die eine BOM verwenden, schwierig sein. 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. Trotz der wenigen Nachteile wird jedoch dringend empfohlen, eine BOM zu verwenden.

Weitere Informationen zur Byte Reihenfolge und zur Byte Reihenfolge-Markierung finden Sie im Unicode-Standard auf der Unicode-Homepage.

Achtung

Um sicherzustellen, dass die codierten Bytes ordnungsgemäß decodiert werden, sollten Sie codierte Bytes mit einer Präambel versehen. Bei den meisten Codierungen wird jedoch keine Präambel bereitgestellt. Um sicherzustellen, dass die codierten Bytes ordnungsgemäß decodiert werden, sollten Sie eine Unicode-Codierung, d. h.,, UTF8EncodingUnicodeEncoding oder UTF32Encoding , mit einer Präambel verwenden.