UTF32Encoding.Preamble Proprietà

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Origine:

UTF32Encoding.cs

Ottiene un byte order mark Unicode codificato in formato UTF-32, se questo oggetto è configurato per fornirne uno.

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)

Valore della proprietà

ReadOnlySpan<Byte>

Intervallo di byte contenente il contrassegno di ordine di byte Unicode, se questo oggetto è configurato per specificarne uno; in caso contrario, un intervallo predefinito.

Commenti

L'oggetto UTF32Encoding può fornire un preambolo, ovvero un intervallo di byte che può essere preceduto dalla sequenza di byte risultanti dal processo di codifica. La prefazione di una sequenza di byte codificati con un contrassegno di ordine di byte (punti U+0000U+FEFFdi codice) consente al decodificatore di determinare l'ordine di byte e il formato di trasformazione o UTF. Il byte order mark Unicode (BOM) viene serializzato come indicato di seguito (in esadecimale):

• Ordine byte big endian: 00 00 FE FF

• Ordine di byte endian piccolo: FF FE 00 00

È possibile creare un'istanza di un UTF32Encoding oggetto la cui Preamble proprietà è una boma valida nei modi seguenti:

• Recuperando l'oggetto UTF32EncodingEncoding.UTF32 restituito dalla proprietà .

• Chiamando il costruttore senza UTF32Encoding() parametri per creare un'istanza di un UTF32Encoding oggetto.

• Specificando true come valore dell'argomento byteOrderMark ai UTF32Encoding costruttori e UTF32Encoding .

È consigliabile usare la BOM, poiché fornisce quasi certamente un'identificazione di una codifica per i file che in caso contrario hanno perso un riferimento all'oggetto UTF32Encoding , ad esempio dati Web senza tag o file di testo non contrassegnati correttamente o file di testo casuali archiviati quando un'azienda non ha problemi internazionali o altri dati. Spesso, i problemi utente potrebbero essere evitati se i dati sono contrassegnati in modo coerente e corretto.

Per gli standard che forniscono un tipo di codifica, un BOM è piuttosto ridondante. Tuttavia, può essere utilizzato per consentire a un server di inviare l'intestazione di codifica corretta. In alternativa, può essere utilizzato come fallback in caso contrario, la codifica andrà persa.

L'utilizzo di un BOM presenta alcuni svantaggi. Ad esempio, sapere come limitare i campi del database che utilizzano un BOM può essere difficile. Anche la concatenazione di file può costituire un problema, ad esempio quando i file vengono uniti in modo tale che un carattere non necessario possa finire nel mezzo dei dati. Nonostante i pochi svantaggi, tuttavia, l'utilizzo di un BOM è altamente consigliato.

Per ulteriori informazioni sull'ordine dei byte e sulla byte order mark, vedere lo standard Unicode nella Home Page Unicode.

Importante

Per assicurarsi che i byte codificati vengano decodificati correttamente, è consigliabile anteporre i byte codificati a un preambolo. Si noti che il GetBytes metodo non prependa un BOM a una sequenza di byte codificati. La fornitura di un BOM all'inizio di un flusso di byte appropriato è responsabilità dello sviluppatore.