次の方法で共有


EncodingProvider.GetEncoding メソッド

定義

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

オーバーロード

GetEncoding(Int32)

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

GetEncoding(String)

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

GetEncoding(Int32, EncoderFallback, DecoderFallback)

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

GetEncoding(String, EncoderFallback, DecoderFallback)

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

GetEncoding(Int32)

ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs

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

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

パラメーター

codepage
Int32

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

戻り値

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

注釈

呼び出し元へのメモ

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

注意 (実装者)

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

GetEncoding(String)

ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs

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

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

パラメーター

name
String

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

戻り値

指定された名前に関連付けられたエンコード。または、この EncodingProvidername に対応する有効なエンコーディングを返すことができない場合は 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(Int32, EncoderFallback, DecoderFallback)

ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs
ソース:
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);
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

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

戻り値

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

注釈

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

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

  • 置換フォールバック。 引数が encoderFallbackEncoderReplacementFallbackインスタンスである場合、または 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(String, EncoderFallback, DecoderFallback)

ソース:
EncodingProvider.cs
ソース:
EncodingProvider.cs
ソース:
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);
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

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

戻り値

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

注釈

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

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

  • 置換フォールバック。 引数が encoderFallbackEncoderReplacementFallbackインスタンスである場合、または 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) 。 ユーザー コードから直接呼び出さないでください。

こちらもご覧ください

適用対象