EncodingProvider.GetEncoding メソッド

定義

名前空間:

System.Text

アセンブリ:

System.Runtime.dll

エンコーディングを返します。

オーバーロード

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

GetEncoding(Int32)

ソース:

EncodingProvider.cs

指定したコード ページ ID に関連付けられたエンコーディングを返します。

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

要求されたエンコードのコード ページ ID。

戻り値

Encoding

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

注釈

呼び出し元へのメモ

このメソッドは Encoding.GetEncoding(Int32) メソッドによって呼び出されます。 ユーザー コードから直接呼び出さないでください。

注意 (実装者)

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

注意 (呼び出し元)

このメソッドは、 メソッドによって呼び出されます GetEncoding(Int32) 。 ユーザー コードから直接呼び出さないでください。

こちらもご覧ください

• GetEncoding(Int32)

GetEncoding(String)

ソース:

EncodingProvider.cs

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

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必要があります。 メソッドが例外をスローする唯一のケースは、 が nullの場合nameです。

呼び出し元へのメモ

このメソッドは、 Encoding.GetEncoding(String) メソッドによって呼び出されます。 ユーザー コードから直接呼び出さないでください。

注意 (実装者)

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

注意 (呼び出し元)

このメソッドは、 メソッドによって呼び出されます GetEncoding(String) 。 ユーザー コードから直接呼び出さないでください。

こちらもご覧ください

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

ソース:

EncodingProvider.cs

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

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

要求されたエンコードのコード ページ ID。

encoderFallback

EncoderFallback

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

decoderFallback

DecoderFallback

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

戻り値

Encoding

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

注釈

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

• 例外フォールバック。 引数が encoderFallback の EncoderExceptionFallbackインスタンスであるか、引数 decoderExceptionFallback が の DecoderExceptionFallbackインスタンスである場合、エンコード メソッドは文字をエンコードできない場合は例外をスローし、バイト シーケンスをデコードできない場合はデコード メソッドによって例外がスローされます。

• 置換フォールバック。 引数が encoderFallback の EncoderReplacementFallbackインスタンスである場合、または decoderExceptionFallback 引数が の DecoderReplacementFallbackインスタンスである場合、エンコードおよびデコード メソッドは、エンコードできない文字とバイト シーケンスをデコードできない置換文字列に置き換えます。 パラメーターなしのコンストラクターを呼び出して置換フォールバック オブジェクトをインスタンス化した場合、置換文字は "?"です。 または DecoderReplacementFallback.DecoderReplacementFallback(String) コンストラクターをEncoderReplacementFallback.EncoderReplacementFallback(String)呼び出す場合は、置換文字列を指定できます。

• 最適なフォールバック。 クラスまたは DecoderFallback クラスからEncoderFallback派生して、最適な置換メカニズムを実装できます。

注意 (継承者)

このメソッドの呼び出しでは メソッドの実装が 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)

ソース:

EncodingProvider.cs

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

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

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

注釈

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

• 例外フォールバック。 引数が encoderFallback の EncoderExceptionFallbackインスタンスであるか、引数 decoderExceptionFallback が の DecoderExceptionFallbackインスタンスである場合、エンコード メソッドは文字をエンコードできない場合は例外をスローし、バイト シーケンスをデコードできない場合はデコード メソッドによって例外がスローされます。

• 置換フォールバック。 引数が encoderFallback の EncoderReplacementFallbackインスタンスである場合、または decoderExceptionFallback 引数が の DecoderReplacementFallbackインスタンスである場合、エンコードおよびデコード メソッドは、エンコードできない文字とバイト シーケンスをデコードできない置換文字列に置き換えます。 パラメーターなしのコンストラクターを呼び出して置換フォールバック オブジェクトをインスタンス化した場合、置換文字は "?"です。 または DecoderReplacementFallback.DecoderReplacementFallback(String) コンストラクターをEncoderReplacementFallback.EncoderReplacementFallback(String)呼び出す場合は、置換文字列を指定できます。

• 最適なフォールバック。 クラスまたは DecoderFallback クラスからEncoderFallback派生して、最適な置換メカニズムを実装できます。

注意 (継承者)

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

注意 (呼び出し元)

このメソッドは、 メソッドによって呼び出されます GetEncoding(String, EncoderFallback, DecoderFallback) 。 ユーザー コードから直接呼び出さないでください。

こちらもご覧ください

• GetEncoding(String, EncoderFallback, DecoderFallback)