CodePagesEncodingProvider.GetEncoding Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.CodePages.dll

Overload

Nama	Deskripsi
GetEncoding(Int32)	Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan.
GetEncoding(String)	Mengembalikan pengodean yang terkait dengan nama halaman kode yang ditentukan.

Keterangan

.NET Framework mendukung sejumlah besar pengodean karakter dan halaman kode. Anda bisa mendapatkan daftar lengkap pengodean dengan memanggil Encoding.GetEncodings metode , yang tersedia di .NET Framework. Di sisi lain, .NET Core hanya mendukung pengodean berikut secara default:

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

Untuk mengambil pengodean yang ada di .NET Framework tetapi tidak di .NET Core, Anda melakukan hal berikut:

• Tambahkan referensi ke rakitan System.Text.Encoding.CodePages.dll ke proyek Anda.

• EncodingProvider Dapatkan objek dari properti statisCodePagesEncodingProvider.Instance.

• Teruskan EncodingProvider objek 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 metode yang EncodingProvider.GetEncoding sesuai untuk menentukan apakah metode tersebut dapat menyediakan pengodean yang diminta.

GetEncoding(Int32)

Sumber:

CodePagesEncodingProvider.cs

Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan.

public:
 override System::Text::Encoding ^ GetEncoding(int codepage);

public override System.Text.Encoding? GetEncoding(int codepage);

override this.GetEncoding : int -> System.Text.Encoding

Public Overrides Function GetEncoding (codepage As Integer) As Encoding

Parameter

codepage

Int32

Pengidentifikasi halaman kode dari pengodean pilihan yang mungkin didukung oleh penyedia pengodean.

Mengembalikan

Encoding

Pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan, atau null jika penyedia tidak mendukung pengodean halaman kode yang diminta.

Keterangan

Metode ini menyediakan akses ke pengodean halaman kode yang tersedia di .NET Framework tetapi tidak didukung secara asli di .NET Core dan versi yang lebih baru.

Kapan codepage adalah 0, metode ini memiliki perilaku khusus yang memengaruhi pengodean default yang dikembalikan oleh GetEncoding(Int32):

• Pada Windows: Mengembalikan pengodean yang cocok dengan halaman kode aktif sistem, menyediakan perilaku yang sama dengan .NET Framework.
• Pada platform non-Windows: Mengembalikan null, memungkinkan GetEncoding(Int32) untuk kembali ke perilaku UTF-8 defaultnya.

Untuk semua pengidentifikasi halaman kode lain yang didukung, metode ini mengembalikan pengodean yang sesuai jika tersedia dari penyedia pengodean halaman kode, atau null jika halaman kode tidak didukung.

GetEncoding(String)

Sumber:

CodePagesEncodingProvider.cs

Mengembalikan pengodean yang terkait dengan nama halaman kode yang ditentukan.

public:
 override System::Text::Encoding ^ GetEncoding(System::String ^ name);

public override System.Text.Encoding? GetEncoding(string name);

override this.GetEncoding : string -> System.Text.Encoding

Public Overrides Function GetEncoding (name As String) As Encoding

Parameter

name

String

Nama halaman kode dari pengodean pilihan yang mungkin didukung oleh penyedia pengodean.

Mengembalikan

Encoding

Pengodean yang terkait dengan halaman kode yang ditentukan, atau null jika penyedia tidak mendukung pengodean yang diminta.