Bagikan melalui


EncodingProvider.GetEncoding Metode

Definisi

Mengembalikan pengodean.

Overload

GetEncoding(Int32)

Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan.

GetEncoding(String)

Mengembalikan pengodean dengan nama 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, 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.

GetEncoding(Int32)

Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs

Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan.

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);
public abstract System.Text.Encoding GetEncoding (int codepage);
public abstract System.Text.Encoding? GetEncoding (int codepage);
abstract member GetEncoding : int -> System.Text.Encoding
Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

Parameter

codepage
Int32

Pengidentifikasi halaman kode dari pengodean yang diminta.

Mengembalikan

Pengodean yang terkait dengan halaman kode yang ditentukan, atau null jika ini EncodingProvider tidak dapat mengembalikan pengodean yang valid yang sesuai dengan codepage.

Keterangan

Catatan untuk pemanggil

Metode ini dipanggil dengan metode Encoding.GetEncoding(Int32). Anda tidak boleh memanggilnya langsung dari kode pengguna.

Catatan Bagi Implementer

Anda mengambil GetEncoding(Int32) alih metode untuk mengembalikan pengodean atau pengodean yang didukung oleh subkelas Anda EncodingProvider . Ketika kode pengguna mencoba mengambil pengodean dengan memanggil GetEncoding(Int32) metode , metode meneruskan codepage pengidentifikasi ke setiap penyedia pengodean terdaftar sampai seseorang mengembalikan pengodean yang valid. Jika tidak ada yang mengembalikan pengodean yang valid, GetEncoding(Int32) metode mencoba mengambil pengodean cache yang pengidentifikasi halaman kodenya adalah codepage. Karena itu, jika codepage bukan pengidentifikasi halaman kode dari pengodean yang Anda dukung, metode harus mengembalikan null; metode tidak boleh melemparkan pengecualian.

Catatan Bagi Pemanggil

Metode ini dipanggil dengan GetEncoding(Int32) metode . Anda tidak boleh memanggilnya langsung dari kode pengguna.

Lihat juga

Berlaku untuk

GetEncoding(String)

Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs

Mengembalikan pengodean dengan nama yang ditentukan.

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);
public abstract System.Text.Encoding GetEncoding (string name);
public abstract System.Text.Encoding? GetEncoding (string name);
abstract member GetEncoding : string -> System.Text.Encoding
Public MustOverride Function GetEncoding (name As String) As Encoding

Parameter

name
String

Nama pengodean yang diminta.

Mengembalikan

Pengodean yang terkait dengan nama yang ditentukan, atau null jika ini EncodingProvider tidak dapat mengembalikan pengodean yang valid yang sesuai dengan name.

Keterangan

Catatan untuk pewaris

Anda mengambil alih metode GetEncoding(String) untuk mengembalikan pengodean atau pengodean yang didukung oleh subkelas Anda EncodingProvider . Ketika kode pengguna mencoba mengambil pengodean dengan memanggil metode GetEncoding(String), metode meneruskan name argumen ke setiap penyedia pengodean terdaftar sampai seseorang mengembalikan pengodean yang valid. Jika tidak ada yang mengembalikan pengodean yang valid, metode GetEncoding(String) mencoba mengambil pengodean cache yang namanya .name Karena itu, jika name bukan nama pengodean yang Anda dukung, metode harus mengembalikan null. Satu-satunya kasus di mana metode harus melempar pengecualian adalah jika name adalah null.

Catatan untuk pemanggil

Metode ini dipanggil oleh metode Encoding.GetEncoding(String ). Anda tidak boleh memanggilnya langsung dari kode pengguna.

Catatan Bagi Implementer

Anda mengambil GetEncoding(String) alih metode untuk mengembalikan pengodean atau pengodean yang didukung oleh subkelas Anda EncodingProvider . Ketika kode pengguna mencoba mengambil pengodean dengan memanggil GetEncoding(String) metode , metode meneruskan name argumen ke setiap penyedia pengodean terdaftar sampai seseorang mengembalikan pengodean yang valid. Jika tidak ada yang mengembalikan pengodean yang valid, GetEncoding(String) metode ini mencoba mengambil pengodean cache yang namanya .name Karena itu, jika name bukan nama pengodean yang Anda dukung, metode harus mengembalikan null. Satu-satunya kasus di mana metode harus melempar pengecualian adalah jika name adalah null.

Catatan Bagi Pemanggil

Metode ini dipanggil dengan GetEncoding(String) metode . Anda tidak boleh memanggilnya langsung dari kode pengguna.

Lihat juga

Berlaku untuk

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs

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.

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);
public virtual System.Text.Encoding GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
public virtual System.Text.Encoding? GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parameter

codepage
Int32

Pengidentifikasi halaman kode dari pengodean yang diminta.

encoderFallback
EncoderFallback

Objek yang menyediakan prosedur penanganan kesalahan ketika karakter tidak dapat dikodekan dengan pengodean ini.

decoderFallback
DecoderFallback

Objek yang menyediakan prosedur penanganan kesalahan ketika urutan byte tidak dapat didekodekan dengan pengodean ini.

Mengembalikan

Pengodean yang terkait dengan halaman kode yang ditentukan, atau null jika ini EncodingProvider tidak dapat mengembalikan pengodean yang valid yang sesuai dengan codepage.

Keterangan

Parameter encoderFallback dan decoderFallback adalah objek yang menentukan strategi fallback yang digunakan jika encoder tidak dapat mengonversi karakter menjadi urutan byte atau dekoder tidak dapat mengonversi urutan byte menjadi karakter. .NET Framework menyediakan mekanisme fallback berikut:

Catatan Bagi Inheritor

Karena panggilan ke metode ini menggunakan implementasi GetEncoding(Int32) metode Anda, Anda tidak perlu mengambil alihnya. Ketika kode pengguna mencoba mengambil pengodean dengan memanggil GetEncoding(Int32, EncoderFallback, DecoderFallback) metode , metode meneruskan codepage pengidentifikasi ke setiap penyedia pengodean terdaftar sampai seseorang mengembalikan pengodean yang valid. Jika tidak ada yang mengembalikan pengodean yang valid, GetEncoding(Int32) metode mencoba mengambil pengodean cache yang pengidentifikasi halaman kodenya adalah codepage. Karena itu, jika Anda memilih untuk mengambil GetEncoding(Int32, EncoderFallback, DecoderFallback) alih metode , penimpaan Anda harus kembali null jika codepage bukan pengidentifikasi halaman kode dari pengodean yang Anda dukung; itu tidak boleh melemparkan pengecualian.

Catatan Bagi Pemanggil

Metode ini dipanggil dengan GetEncoding(Int32, EncoderFallback, DecoderFallback) metode . Anda tidak boleh memanggilnya langsung dari kode pengguna.

Lihat juga

Berlaku untuk

GetEncoding(String, EncoderFallback, DecoderFallback)

Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs
Sumber:
EncodingProvider.cs

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.

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);
public virtual System.Text.Encoding GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
public virtual System.Text.Encoding? GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);
abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parameter

name
String

Nama pengodean yang disukai.

encoderFallback
EncoderFallback

Objek yang menyediakan prosedur penanganan kesalahan ketika karakter tidak dapat dikodekan dengan pengodean ini.

decoderFallback
DecoderFallback

Objek yang menyediakan prosedur penanganan kesalahan ketika urutan byte tidak dapat didekodekan dengan pengodean saat ini.

Mengembalikan

Pengodean yang terkait dengan nama yang ditentukan, atau null jika ini EncodingProvider tidak dapat mengembalikan pengodean yang valid yang sesuai dengan name.

Keterangan

Parameter encoderFallback dan decoderFallback adalah objek yang menentukan strategi fallback yang digunakan jika encoder tidak dapat mengonversi karakter menjadi urutan byte atau dekoder tidak dapat mengonversi urutan byte menjadi karakter. .NET Framework menyediakan mekanisme fallback berikut:

Catatan Bagi Inheritor

Karena panggilan ke metode ini menggunakan implementasi GetEncoding(String) metode Anda, Anda tidak perlu mengambil alihnya. Ketika kode pengguna mencoba mengambil pengodean dengan memanggil GetEncoding(String, EncoderFallback, DecoderFallback) metode , metode meneruskan codepage pengidentifikasi ke setiap penyedia pengodean terdaftar sampai seseorang mengembalikan pengodean yang valid. Jika tidak ada yang mengembalikan pengodean yang valid, GetEncoding(Int32) metode mencoba mengambil pengodean cache yang pengidentifikasi halaman kodenya adalah codepage. Karena itu, jika Anda memilih untuk mengambil GetEncoding(Int32, EncoderFallback, DecoderFallback) alih metode , penimpaan Anda harus kembali null jika codepage bukan pengidentifikasi halaman kode dari pengodean yang Anda dukung; itu tidak boleh melemparkan pengecualian.

Catatan Bagi Pemanggil

Metode ini dipanggil dengan GetEncoding(String, EncoderFallback, DecoderFallback) metode . Anda tidak boleh memanggilnya langsung dari kode pengguna.

Lihat juga

Berlaku untuk