UTF32Encoding.Preamble Eigenschaft

Definition

Namespace:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Quelle:

UTF32Encoding.cs

Ruft ein Unicode-Bytereihenfolgenzeichen ab, das im UTF-32-Format codiert ist, wenn dieses Objekt so konfiguriert ist, dass eins bereitgestellt wird.

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

ReadOnlySpan<Byte>

Eine Bytespanne, die das Unicode-Bytereihenfolgezeichen enthält, wenn dieses Objekt so konfiguriert ist, dass eins bereitgestellt wird; andernfalls eine Standardspanne.

Hinweise

Das UTF32Encoding-Objekt kann eine Präambel bereitstellen, bei der es sich um eine Bytespanne handelt, die der Sequenz von Bytes vorangestellt werden kann, die sich aus dem Codierungsprozess ergibt. Durch das Voranstellen einer Sequenz codierter Bytes mit einem Bytereihenfolgezeichen (Codepunkte U+0000U+FEFF) kann der Decoder die Bytereihenfolge und das Transformationsformat oder UTF bestimmen. Das Unicode-Bytereihenfolgezeichen (BOM) wird wie folgt serialisiert (hexadezimal):

• Big Endian Byte Order: 00 00 FE FF

• Kleine endische Bytereihenfolge: FF FE 00 00

Sie können ein UTF32Encoding-Objekt instanziieren, dessen Preamble Eigenschaft eine gültige BOM auf folgende Weise ist:

• Durch Abrufen des UTF32Encoding Objekts, das von der Encoding.UTF32-Eigenschaft zurückgegeben wird.

• Durch Aufrufen des parameterlosen UTF32Encoding()-Konstruktors zum Instanziieren eines UTF32Encoding-Objekts.

• Indem Sie true als Wert des arguments byteOrderMark für die UTF32Encoding und UTF32Encoding Konstruktoren angeben.

Es wird empfohlen, die BOM zu verwenden, da sie nahezu bestimmte Identifizierung einer Codierung für Dateien bereitstellt, die andernfalls einen Verweis auf das UTF32Encoding-Objekt verloren haben, z. B. nicht markierte oder nicht markierte Webdaten, oder zufällige Textdateien, die gespeichert wurden, wenn ein Unternehmen keine internationalen Bedenken oder andere Daten hatte. Häufig können Benutzerprobleme vermieden werden, wenn Daten konsistent und ordnungsgemäß markiert sind.

Für Standards, die einen Codierungstyp bereitstellen, ist eine BOM etwas redundant. Es kann jedoch verwendet werden, um einem Server zu helfen, den richtigen Codierungsheader zu senden. Alternativ kann sie als Fallback verwendet werden, falls die Codierung andernfalls verloren geht.

Es gibt einige Nachteile bei der Verwendung einer BOM. Beispielsweise kann es schwierig sein, die Datenbankfelder zu beschränken, die eine BOM verwenden. Die Verkettung von Dateien kann beispielsweise auch ein Problem sein, wenn Dateien so zusammengeführt werden, dass ein unnötiges Zeichen in der Mitte der Daten enden kann. Trotz der wenigen Nachteile wird die Verwendung eines BOM jedoch dringend empfohlen.

Weitere Informationen zur Bytereihenfolge und zum Bytereihenfolgenzeichen finden Sie unter Unicode Standard auf der Unicode-Homepage.

Wichtig

Um sicherzustellen, dass die codierten Bytes ordnungsgemäß decodiert werden, sollten Sie mit einem Präambel codierte Bytes voranstellen. Beachten Sie, dass die GetBytes-Methode keine BOM einer Sequenz codierter Bytes vorangestellt hat; Die Bereitstellung eines BOM am Anfang eines geeigneten Bytestreams liegt in der Verantwortung des Entwicklers.