Encoding.Preamble Properti

Definisi

Ruang nama:

System.Text

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

Encoding.cs

Saat ditimpa dalam kelas turunan, mengembalikan rentang yang berisi urutan byte yang menentukan pengodean yang digunakan.

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)

Nilai Properti

ReadOnlySpan<Byte>

Rentang byte yang berisi urutan byte yang menentukan pengodean yang digunakan, atau rentang panjang nol, jika pembukaan tidak diperlukan.

Keterangan

Secara opsional, Encoding objek menyediakan awalan yang merupakan urutan byte yang dapat diawali dengan byte yang dihasilkan dari proses pengodean. Jika preamble berisi tanda urutan byte (di Unicode, titik kode U+FEFF), itu membantu dekoder menentukan urutan byte dan format transformasi atau UTF.

Tanda urutan byte Unicode (BOM) diserialisasikan sebagai berikut (dalam heksadesimal):

• UTF-8: EF BB BF

• Urutan byte big endian UTF-16: FE FF

• Urutan byte little endian UTF-16: FF FE

• Pesanan byte big endian UTF-32: 00 00 FE FF

• Urutan byte little endian UTF-32: FF FE 00 00

Anda harus menggunakan BOM, karena menyediakan identifikasi pengodean yang hampir pasti untuk file yang kehilangan referensi ke objek, misalnya, data web yang tidak diberi tag atau tidak benar atau file teks acak yang disimpan ketika bisnis tidak memiliki kekhawatiran Encoding internasional atau data lainnya. Seringkali masalah pengguna mungkin dihindari jika data ditandai dengan konsisten dan benar, sebaiknya di UTF-8 atau UTF-16.

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. Meskipun ada beberapa kelemahan, namun, penggunaan BOM sangat disarankan.

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

Caution

Untuk memastikan bahwa byte yang dikodekan didekode dengan benar, Anda harus awali byte yang dikodekan dengan awalan. Namun, sebagian besar pengodean tidak menyediakan preamble. Untuk memastikan bahwa byte yang dikodekan didekodekan dengan benar, Anda harus menggunakan pengodean Unicode, yaitu, , UTF8EncodingUnicodeEncoding, atau UTF32Encoding, dengan dapat dikodekan sebelumnya.