EncodingProvider.GetEncoding Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

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

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);

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

Encoding

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

• GetEncoding(Int32)

GetEncoding(String)

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);

abstract member GetEncoding : string -> System.Text.Encoding

Public MustOverride Function GetEncoding (name As String) As Encoding

Parameter

name

String

Nama pengodean yang diminta.

Mengembalikan

Encoding

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

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

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);

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

Encoding

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:

• Fallback pengecualian. encoderFallback Jika argumen adalah instans EncoderExceptionFallback, atau decoderExceptionFallback argumen adalah instans dari DecoderExceptionFallback, metode pengodean melempar pengecualian jika karakter tidak dapat dikodekan, dan metode pendekodean memberikan pengecualian jika urutan byte tidak dapat didekodekan.

• Penggantian fallback. encoderFallback Jika argumen adalah instans EncoderReplacementFallback, atau decoderExceptionFallback argumen adalah instans dari , metode pengodean DecoderReplacementFallbackdan pendekodean menggantikan string pengganti untuk karakter yang tidak dapat dikodekan dan urutan byte tidak dapat didekodekan. Jika Anda membuat instans objek fallback pengganti dengan memanggil konstruktor tanpa parameter, karakter penggantinya adalah "?". Jika Anda memanggil EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktor atau DecoderReplacementFallback.DecoderReplacementFallback(String) , Anda dapat menentukan string pengganti.

• Fallback yang paling cocok. Anda dapat memperoleh dari EncoderFallback kelas atau DecoderFallback untuk menerapkan mekanisme penggantian yang paling sesuai.

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

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

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);

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

Encoding

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:

• Fallback pengecualian. encoderFallback Jika argumen adalah instans EncoderExceptionFallback, atau decoderExceptionFallback argumen adalah instans dari DecoderExceptionFallback, metode pengodean melempar pengecualian jika karakter tidak dapat dikodekan, dan metode pendekodean memberikan pengecualian jika urutan byte tidak dapat didekodekan.

• Penggantian fallback. encoderFallback Jika argumen adalah instans EncoderReplacementFallback, atau decoderExceptionFallback argumen adalah instans dari , metode pengodean DecoderReplacementFallbackdan pendekodean menggantikan string pengganti untuk karakter yang tidak dapat dikodekan dan urutan byte tidak dapat didekodekan. Jika Anda membuat instans objek fallback pengganti dengan memanggil konstruktor tanpa parameter, karakter penggantinya adalah "?". Jika Anda memanggil EncoderReplacementFallback.EncoderReplacementFallback(String) konstruktor atau DecoderReplacementFallback.DecoderReplacementFallback(String) , Anda dapat menentukan string pengganti.

• Fallback yang paling cocok. Anda dapat memperoleh dari EncoderFallback kelas atau DecoderFallback untuk menerapkan mekanisme penggantian yang paling sesuai.

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

• GetEncoding(String, EncoderFallback, DecoderFallback)