EncodingProvider Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Sumber:

EncodingProvider.cs

Menyediakan kelas dasar untuk penyedia pengodean, yang memasok pengodean yang tidak tersedia pada platform tertentu.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Warisan

Object

EncodingProvider

Turunan

System.Text.CodePagesEncodingProvider

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 nilai true.

• 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 nilai true 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:

1. 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.

2. 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.

3. Teruskan EncodingProvider instans ke Encoding.RegisterProvider metode untuk membuat pengodean yang disediakan oleh EncodingProvider objek tersedia untuk runtime bahasa umum.

4. 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)

Lihat juga

• GetEncoding(String)
• Instance