UTF32Encoding.Preamble Properti

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.Extensions.dll

Sumber:

UTF32Encoding.cs

Mendapatkan tanda urutan byte Unicode yang dikodekan dalam format UTF-32, jika objek ini dikonfigurasi untuk menyediakannya.

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)

Nilai Properti

ReadOnlySpan<Byte>

Rentang byte yang berisi tanda urutan byte Unicode, jika objek ini dikonfigurasi untuk menyediakannya; jika tidak, rentang default.

Keterangan

Objek UTF32Encoding dapat memberikan awalan, yang merupakan rentang byte yang dapat diawali dengan urutan byte yang dihasilkan dari proses pengodean. Prefacing urutan byte yang dikodekan dengan tanda urutan byte (titik kode U+0000U+FEFF) membantu dekoder menentukan urutan byte dan format transformasi, atau UTF. Tanda urutan byte Unicode (BOM) diserialisasikan sebagai berikut (dalam heksadesimal):

• Urutan byte big endian: 00 00 FE FF

• Urutan byte little endian: FF FE 00 00

Anda dapat membuat instans objek UTF32Encoding yang properti Preamble-nya adalah BOM yang valid dengan cara berikut:

• Dengan mengambil objek UTF32Encoding yang dikembalikan oleh properti Encoding.UTF32.

• Dengan memanggil konstruktor UTF32Encoding() tanpa parameter untuk membuat instans objek UTF32Encoding.

• Dengan menyediakan true sebagai nilai argumen byteOrderMark ke konstruktor UTF32Encoding dan UTF32Encoding.

Kami menyarankan agar Anda menggunakan BOM, karena menyediakan identifikasi yang hampir pasti dari pengodean untuk file yang jika tidak kehilangan referensi ke objek UTF32Encoding, seperti data web yang tidak diberi tag atau tidak benar, atau file teks acak yang disimpan ketika bisnis tidak memiliki kekhawatiran internasional atau data lainnya. Seringkali, masalah pengguna mungkin dihindari jika data ditandai dengan konsisten dan benar.

Untuk standar yang menyediakan jenis pengodean, BOM agak berlebihan. Namun, ini dapat digunakan untuk membantu server mengirim header pengodean yang benar. Atau, ini dapat digunakan sebagai fallback jika pengodean hilang.

Ada beberapa kelemahan menggunakan BOM. Misalnya, mengetahui cara membatasi bidang database yang menggunakan BOM bisa sulit. Penggabungan file juga dapat menjadi masalah, misalnya, ketika file digabungkan sewaktu-waktu sehingga karakter yang tidak perlu dapat berakhir di tengah data. Terlepas dari beberapa kelemahan, namun, penggunaan BOM sangat disarankan.

Untuk informasi selengkapnya tentang urutan byte dan tanda urutan byte, lihat Standar Unicode di halaman beranda unicode .

Penting

Untuk memastikan bahwa byte yang dikodekan didekode dengan benar, Anda harus awali byte yang dikodekan dengan awalan. Perhatikan bahwa metode GetBytes tidak menambahkan BOM ke urutan byte yang dikodekan; menyediakan BOM di awal aliran byte yang sesuai adalah tanggung jawab pengembang.