Console.OutputEncoding Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur pengodean yang digunakan konsol untuk menulis output.
public:
static property System::Text::Encoding ^ OutputEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };
public static System.Text.Encoding OutputEncoding { get; set; }
public static System.Text.Encoding OutputEncoding { get; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
static member OutputEncoding : System.Text.Encoding with get, set
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding
Nilai Properti
Pengodean yang digunakan untuk menulis output konsol.
- Atribut
Pengecualian
Nilai properti dalam operasi yang ditetapkan adalah null
.
Terjadi kesalahan selama eksekusi operasi ini.
Aplikasi Anda tidak memiliki izin untuk melakukan operasi ini.
Keterangan
Konsol menggunakan pengodean output untuk menerjemahkan karakter yang ditulis oleh aplikasi ke dalam karakter tampilan konsol yang sesuai. Halaman kode default yang digunakan konsol ditentukan oleh lokal sistem.
Dimulai dengan .NET Framework 4, operasi get properti dapat mengembalikan nilai yang di-cache alih-alih pengodean output konsol saat ini. Ini dapat terjadi jika nilai OutputEncoding properti dimodifikasi dengan beberapa cara selain penugasan ke OutputEncoding properti , seperti memanggil fungsi Windows SetConsoleOutputCP
.
Catatan Bagi Pemanggil
Dari pengodean Unicode, Console kelas mendukung pengodean UTF-8 dengan UTF8Encoding kelas dan, dimulai dengan .NET Framework 4.5, mendukung pengodean UTF-16 dengan UnicodeEncoding kelas . Pengodean UTF-32 dengan UTF32Encoding kelas tidak didukung. Mencoba mengatur pengodean output ke UTF-32 melempar IOException.
Perhatikan bahwa berhasil menampilkan karakter Unicode ke konsol memerlukan hal berikut:
Konsol harus menggunakan font TrueType, seperti Lucida Console atau Consolas, untuk menampilkan karakter.
Font yang digunakan oleh konsol harus menentukan glyph atau glyph tertentu yang akan ditampilkan. Konsol dapat memanfaatkan penautan font untuk menampilkan glyph dari font tertaut jika font dasar tidak berisi definisi untuk glyph tersebut.
Untuk informasi selengkapnya tentang dukungan untuk pengodean Unicode oleh konsol, lihat bagian "Dukungan Unicode untuk Konsol" di Console kelas .