EncodingProvider.GetEncoding メソッド

定義

名前空間:: System.Text

アセンブリ:: mscorlib.dll, System.Text.Encoding.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.Text.Encoding.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

エンコードを返します。

オーバーロード

名前	説明
GetEncoding(Int32)	指定したコードページ識別子に関連付けられているエンコードを返します。
GetEncoding(String)	指定した名前のエンコードを返します。
GetEncoding(Int32, EncoderFallback, DecoderFallback)	指定したコードページ識別子に関連付けられているエンコードを返します。パラメーターは、エンコードできない文字とデコードできないバイトシーケンスのエラーハンドラーを指定します。
GetEncoding(String, EncoderFallback, DecoderFallback)	指定した名前に関連付けられているエンコードを返します。パラメーターは、エンコードできない文字とデコードできないバイトシーケンスのエラーハンドラーを指定します。

GetEncoding(Int32)

指定したコードページ識別子に関連付けられているエンコードを返します。

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

パラメーター

codepage: Int32

要求されたエンコードのコードページ識別子。

返品

Encoding

指定したコードページに関連付けられているエンコード。または、このEncodingProviderがcodepageに対応する有効なエンコードを返すことができない場合にnullします。

注釈

呼び出し側への注意

このメソッドは、Encoding.GetEncoding(Int32) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

注意 (実装者)

GetEncoding(Int32) メソッドをオーバーライドして、EncodingProvider サブクラスでサポートされているエンコーディングを返します。ユーザーコードが GetEncoding(Int32) メソッドを呼び出してエンコードを取得しようとすると、メソッドは、有効なエンコードを返すまで、登録されているすべてのエンコードプロバイダーに codepage 識別子を渡します。有効なエンコードが返されない場合、 GetEncoding(Int32) メソッドは、コードページ識別子が codepageされているキャッシュされたエンコードの取得を試みます。このため、 codepage がサポートするエンコーディングのコードページ識別子でない場合、メソッドは nullを返す必要があります。例外をスローしないでください。

注意 (呼び出し元)

このメソッドは、 GetEncoding(Int32) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

こちらもご覧ください

GetEncoding(Int32)

適用対象

GetEncoding(String)

指定した名前のエンコードを返します。

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

パラメーター

name: String

要求されたエンコードの名前。

返品

Encoding

指定した名前に関連付けられているエンコード。または、このEncodingProviderがnameに対応する有効なエンコードを返すことができない場合にnullします。

注釈

継承者へのメモ

getEncoding(String) メソッドをオーバーライドして、EncodingProvider サブクラスでサポートされているエンコーディングを返します。ユーザーコードが GetEncoding(String) メソッドを呼び出してエンコードを取得しようとすると、メソッドは有効なエンコードを返すまで、登録されているすべてのエンコードプロバイダーに name 引数を渡します。有効なエンコードが返されない場合、 GetEncoding(String) メソッドは、 name名前のキャッシュされたエンコードの取得を試みます。このため、 name がサポートするエンコーディングの名前でない場合、メソッドは nullを返す必要があります。メソッドが例外をスローする唯一のケースは、 name が null場合です。

呼び出し側への注意

このメソッドは、Encoding.GetEncoding(String) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

注意 (実装者)

GetEncoding(String) メソッドをオーバーライドして、EncodingProvider サブクラスでサポートされているエンコーディングを返します。ユーザーコードが GetEncoding(String) メソッドを呼び出してエンコードを取得しようとすると、メソッドは有効なエンコードを返すまで、登録されているすべてのエンコードプロバイダーに name 引数を渡します。有効なエンコードが返されない場合、 GetEncoding(String) メソッドは、名前が nameキャッシュされたエンコードの取得を試みます。このため、 name がサポートするエンコーディングの名前でない場合、メソッドは nullを返す必要があります。メソッドが例外をスローする唯一のケースは、 name が null場合です。

注意 (呼び出し元)

このメソッドは、 GetEncoding(String) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

こちらもご覧ください

GetEncoding(String)

適用対象

GetEncoding(Int32, EncoderFallback, 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

パラメーター

codepage: Int32

要求されたエンコードのコードページ識別子。

encoderFallback: EncoderFallback

このエンコードで文字をエンコードできない場合にエラー処理プロシージャを提供するオブジェクト。

decoderFallback: DecoderFallback

バイトシーケンスをこのエンコードでデコードできない場合にエラー処理プロシージャを提供するオブジェクト。

返品

Encoding

注釈

encoderFallbackパラメーターとdecoderFallback パラメーターは、エンコーダーが文字をバイトシーケンスに変換できない場合、またはデコーダーがバイトシーケンスを文字に変換できない場合に使用されるフォールバック戦略を定義するオブジェクトです。 .NET Framework には、次のフォールバックメカニズムが用意されています。

例外フォールバック。 encoderFallback引数がEncoderExceptionFallbackのインスタンスであるか、decoderExceptionFallback引数がDecoderExceptionFallbackのインスタンスである場合、エンコードメソッドは文字をエンコードできない場合に例外をスローし、デコードメソッドはバイトシーケンスをデコードできない場合に例外をスローします。
代替フォールバック。 encoderFallback引数がEncoderReplacementFallbackのインスタンスであるか、decoderExceptionFallback引数がDecoderReplacementFallbackのインスタンスである場合、エンコードおよびデコードメソッドは、エンコードできない文字とバイトシーケンスをデコードできない文字の置換文字列に置き換えます。パラメーターなしのコンストラクターを呼び出して置換フォールバックオブジェクトをインスタンス化した場合、置換文字は "?"" になります。 EncoderReplacementFallback.EncoderReplacementFallback(String)またはDecoderReplacementFallback.DecoderReplacementFallback(String)コンストラクターを呼び出す場合は、置換文字列を指定できます。
最適なフォールバック。 EncoderFallbackまたはDecoderFallback クラスから派生して、最適な置換メカニズムを実装できます。

注意 (継承者)

このメソッドの呼び出しでは、 GetEncoding(Int32) メソッドの実装が使用されるため、オーバーライドする必要はありません。ユーザーコードが GetEncoding(Int32, EncoderFallback, DecoderFallback) メソッドを呼び出してエンコードを取得しようとすると、メソッドは、有効なエンコードを返すまで、登録されているすべてのエンコードプロバイダーに codepage 識別子を渡します。有効なエンコードが返されない場合、 GetEncoding(Int32) メソッドは、コードページ識別子が codepageされているキャッシュされたエンコードの取得を試みます。このため、GetEncoding(Int32, EncoderFallback, DecoderFallback) メソッドをオーバーライドすることを選択した場合、codepageがサポートするエンコーディングのコードページ識別子でない場合、オーバーライドはnullを返す必要があります。例外はスローされません。

注意 (呼び出し元)

このメソッドは、 GetEncoding(Int32, EncoderFallback, DecoderFallback) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

こちらもご覧ください

GetEncoding(Int32, EncoderFallback, DecoderFallback)

適用対象

GetEncoding(String, EncoderFallback, DecoderFallback)

指定した名前に関連付けられているエンコードを返します。パラメーターは、エンコードできない文字とデコードできないバイトシーケンスのエラーハンドラーを指定します。

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

パラメーター

name: String

優先エンコードの名前。

encoderFallback: EncoderFallback

このエンコードで文字をエンコードできない場合にエラー処理プロシージャを提供するオブジェクト。

decoderFallback: DecoderFallback

バイトシーケンスを現在のエンコードでデコードできない場合にエラー処理プロシージャを提供するオブジェクト。

返品

Encoding

注釈

encoderFallbackパラメーターとdecoderFallback パラメーターは、エンコーダーが文字をバイトシーケンスに変換できない場合、またはデコーダーがバイトシーケンスを文字に変換できない場合に使用されるフォールバック戦略を定義するオブジェクトです。 .NETには、次のフォールバックメカニズムが用意されています。

例外フォールバック。 encoderFallback引数がEncoderExceptionFallbackのインスタンスであるか、decoderExceptionFallback引数がDecoderExceptionFallbackのインスタンスである場合、エンコードメソッドは文字をエンコードできない場合に例外をスローし、デコードメソッドはバイトシーケンスをデコードできない場合に例外をスローします。
代替フォールバック。 encoderFallback引数がEncoderReplacementFallbackのインスタンスであるか、decoderExceptionFallback引数がDecoderReplacementFallbackのインスタンスである場合、エンコードおよびデコードメソッドは、エンコードできない文字とバイトシーケンスをデコードできない文字の置換文字列に置き換えます。パラメーターなしのコンストラクターを呼び出して置換フォールバックオブジェクトをインスタンス化した場合、置換文字は "?"" になります。 EncoderReplacementFallback.EncoderReplacementFallback(String)またはDecoderReplacementFallback.DecoderReplacementFallback(String)コンストラクターを呼び出す場合は、置換文字列を指定できます。
最適なフォールバック。 EncoderFallbackまたはDecoderFallback クラスから派生して、最適な置換メカニズムを実装できます。

注意 (呼び出し元)

このメソッドは、 GetEncoding(String, EncoderFallback, DecoderFallback) メソッドによって呼び出されます。ユーザーコードから直接呼び出すべきではありません。

こちらもご覧ください

GetEncoding(String, EncoderFallback, DecoderFallback)

適用対象

フィードバック

このページはお役に立ちましたか?