Encoding.Default Properti

Definisi

Ruang nama:

System.Text

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

Encoding.cs

Mendapatkan pengodean default untuk implementasi .NET ini.

public:
 static property System::Text::Encoding ^ Default { System::Text::Encoding ^ get(); };

public static System.Text.Encoding Default { get; }

static member Default : System.Text.Encoding

Public Shared ReadOnly Property Default As Encoding

Nilai Properti

Encoding

Pengodean default untuk implementasi .NET ini.

Keterangan

Perilaku Default properti bervariasi di antara implementasi .NET yang berbeda:

• Di .NET Framework: Mengembalikan pengodean yang sesuai dengan halaman kode aktif sistem. Ini adalah pengodean yang sama yang dikembalikan oleh GetEncoding(Int32) ketika dipanggil dengan codepage argumen .0

• Di .NET Core dan versi yang lebih baru: Selalu mengembalikan UTF8Encoding objek. Perilaku ini diubah untuk mendorong penggunaan pengodean Unicode untuk kompatibilitas lintas platform dan integritas data yang lebih baik.

Untuk hasil yang paling konsisten di berbagai platform dan implementasi .NET, pertimbangkan untuk menggunakan pengodean Unicode tertentu seperti UTF-8 secara langsung alih-alih mengandalkan pengodean default. Anda dapat memperoleh pengodean UTF-8 dengan memanggil Encoding.UTF8 atau Encoding.GetEncoding(String) dengan "utf-8".

Warning

Komputer yang berbeda dapat menggunakan pengodean yang berbeda sebagai default, dan pengodean default dapat berubah pada satu komputer. Jika Anda menggunakan Encoding.Default pengodean untuk mengodekan dan mendekode data yang dialirkan antar komputer atau diambil pada waktu yang berbeda di komputer yang sama, data tersebut mungkin salah diterjemahkan. Selain itu, pengodean yang dihasilkan oleh properti Default menggunakan penyesuaian terbaik untuk memetakan karakter yang tidak dapat didukung ke karakter yang didukung oleh kode halaman. Untuk alasan ini, menggunakan pengodean default tidak disarankan. Untuk memastikan bahwa byte yang dikodekan didekodekan dengan benar, Anda harus menggunakan pengodean Unicode, seperti UTF8Encoding atau UnicodeEncoding. Anda juga dapat menggunakan protokol tingkat yang lebih tinggi untuk memastikan bahwa format yang sama digunakan untuk pengodean dan dekode.

Properti Default selalu mengembalikan UTF8Encoding. UTF-8 didukung pada semua sistem operasi (Windows, Linux, dan macOS) tempat aplikasi .NET berjalan.