CodePagesEncodingProvider Kelas
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.
Menyediakan akses ke penyedia pengodean untuk halaman kode yang hanya tersedia di desktop .NET Framework.
public ref class CodePagesEncodingProvider sealed
public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider
[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider
public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider
[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class
type CodePagesEncodingProvider = class
inherit EncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider
- Warisan
-
CodePagesEncodingProvider
- Warisan
- Atribut
Keterangan
.NET Framework untuk desktop Windows mendukung serangkaian besar pengodean halaman Unicode dan kode. .NET Core, di sisi lain, hanya mendukung pengodean berikut:
ASCII (halaman kode 20127), yang dikembalikan oleh Encoding.ASCII properti .
ISO-8859-1 (halaman kode 28591).
UTF-7 (halaman kode 65000), yang dikembalikan oleh Encoding.UTF7 properti .
UTF-8 (halaman kode 65001), yang dikembalikan oleh Encoding.UTF8 properti .
UTF-16 dan UTF-16LE (halaman kode 1200), yang dikembalikan oleh Encoding.Unicode properti .
UTF-16BE (halaman kode 1201), yang dibuat dengan memanggil UnicodeEncoding.UnicodeEncoding atau UnicodeEncoding.UnicodeEncoding konstruktor dengan
bigEndiannilaitrue.UTF-32 dan UTF-32LE (halaman kode 12000), yang dikembalikan oleh Encoding.UTF32 properti .
UTF-32BE (halaman kode 12001), yang dibuat dengan memanggil UTF32Encoding konstruktor yang memiliki
bigEndianparameter dan memberikan nilaitruedalam panggilan metode.
Selain halaman kode 20127, pengodean halaman kode tidak didukung.
Kelas diperluas CodePagesEncodingProviderEncodingProvider untuk membuat halaman kode ini tersedia untuk .NET Core. Untuk menggunakan halaman kode tambahan ini, Anda melakukan hal berikut:
CodePagesEncodingProvider Ambil objek dari properti statisCodePagesEncodingProvider.Instance.
Teruskan CodePagesEncodingProvider objek ke Encoding.RegisterProvider metode .
EncodingProvider Setelah objek terdaftar, pengodean yang didukungnya tersedia dengan memanggil kelebihan beban Encoding.GetEncoding; Anda tidak boleh memanggil EncodingProvider.GetEncoding kelebihan beban.
Dampak pada perilaku pengodean default
CodePagesEncodingProvider Mendaftar juga memengaruhi perilaku GetEncoding(Int32) ketika dipanggil dengan codepage argumen 0 di .NET (Core):
- Di Windows,
GetEncoding(0)mengembalikan pengodean yang cocok dengan halaman kode aktif sistem, yang merupakan perilaku yang sama seperti dalam .NET Framework. - Pada platform non-Windows,
GetEncoding(0)mengembalikan UTF-8, mempertahankan konsistensi lintas platform.
Ketika tidak ada penyedia pengodean yang terdaftar, GetEncoding(0) mengembalikan UTF-8 pada semua platform di .NET Core dan versi yang lebih baru.
Properti
| Nama | Deskripsi |
|---|---|
| Instance |
Mendapatkan penyedia pengodean untuk halaman kode yang didukung di desktop .NET Framework tetapi tidak di platform .NET Framework saat ini. |
Metode
| Nama | Deskripsi |
|---|---|
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetEncoding(Int32, EncoderFallback, DecoderFallback) |
Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan. Parameter menentukan handler kesalahan untuk karakter yang tidak dapat dikodekan dan urutan byte yang tidak dapat didekodekan. (Diperoleh dari EncodingProvider) |
| GetEncoding(Int32) |
Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan. |
| GetEncoding(String, EncoderFallback, DecoderFallback) |
Mengembalikan pengodean yang terkait dengan nama yang ditentukan. Parameter menentukan handler kesalahan untuk karakter yang tidak dapat dikodekan dan urutan byte yang tidak dapat didekodekan. (Diperoleh dari EncodingProvider) |
| GetEncoding(String) |
Mengembalikan pengodean yang terkait dengan nama halaman kode yang ditentukan. |
| GetEncodings() |
Mengembalikan array yang berisi semua pengodean yang didukung oleh CodePagesEncodingProvider. |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |