EncodingProvider 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 kelas dasar untuk penyedia pengodean, yang memasok pengodean yang tidak tersedia pada platform tertentu.
public ref class EncodingProvider abstract
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
- Warisan
-
EncodingProvider
- Turunan
- Atribut
Keterangan
Penyedia pengodean menyediakan pengodean yang tidak tersedia di platform target tertentu.
.NET Framework mendukung sejumlah besar pengodean karakter dan halaman kode. Anda bisa mendapatkan daftar lengkap pengodean yang tersedia di .NET Framework dengan memanggil Encoding.GetEncodings metode . .NET Core, di sisi lain, secara default 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 Unicode properti .
UTF-16BE (halaman kode 1201), yang dibuat dengan memanggil UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) atau UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) konstruktor dengan
bigEndian
nilaitrue
.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
bigEndian
parameter dan memberikan nilaitrue
dalam panggilan metode.
Dimulai dengan .NET Framework 4.6, EncodingProvider adalah kelas dasar yang membuat pengodean yang tidak tersedia tersedia untuk .NET Framework. Tindakan ini memerlukan langkah-langkah berikut:
Tentukan subkelas EncodingProvider yang mengambil alih dua kelebihan abstrak GetEncoding , GetEncoding(Int32) dan GetEncoding(String). Kelebihan beban ini mengembalikan pengodean yang tidak didukung oleh pengidentifikasi halaman kode dan berdasarkan nama. Perhatikan bahwa Anda juga dapat memilih untuk mengembalikan pengodean default jika GetEncoding(Int32) metode dipanggil dengan argumen 0.
Secara opsional, Anda dapat mengambil alih metode dan GetEncoding(String, EncoderFallback, DecoderFallback) virtualGetEncoding(Int32, EncoderFallback, DecoderFallback). Dalam kebanyakan kasus, ini tidak diperlukan, karena kelas dasar menyediakan implementasi default.
Teruskan EncodingProvider instans ke Encoding.RegisterProvider metode untuk membuat pengodean yang disediakan oleh EncodingProvider objek tersedia untuk runtime bahasa umum.
Encoding.GetEncoding Panggil kelebihan beban untuk mengambil pengodean. Metode ini Encoding.GetEncoding akan memanggil yang sesuai EncodingProvider.GetEncoding untuk menentukan apakah metode tersebut dapat menyediakan pengodean yang diminta.
Pustaka Kelas .NET Framework menyediakan satu properti statis, CodePagesEncodingProvider.Instance, yang mengembalikan EncodingProvider objek yang membuat serangkaian pengodean lengkap tersedia di Desktop .NET Framework Class Library tersedia untuk aplikasi .NET Core. Selain itu, Anda dapat memperoleh dari EncodingProvider kelas untuk membuat pengodean Anda sendiri tersedia.
Konstruktor
EncodingProvider() |
Menginisialisasi instans baru kelas EncodingProvider. |
Metode
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetEncoding(Int32) |
Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan. |
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. |
GetEncoding(String) |
Mengembalikan pengodean dengan nama 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. |
GetEncodings() |
Mengembalikan array yang berisi semua pengodean yang didukung oleh EncodingProvider. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |