DecoderFallback クラス

.NET Framework クラス ライブラリ リファレンス

DecoderFallback クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

エンコード済み入力バイト シーケンスを出力文字に変換できない場合のために、フォールバックと呼ばれるエラー処理機構を提供します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public MustInherit Class
 DecoderFallback

Visual Basic (使用法)

Dim instance As DecoderFallback

C#

[SerializableAttribute] 
public abstract class DecoderFallback

C++

[SerializableAttribute] 
public ref class DecoderFallback abstract

J#

/** @attribute SerializableAttribute() */ 
public abstract class DecoderFallback

JScript

SerializableAttribute 
public abstract class DecoderFallback

解説

エンコーディングでは、Unicode 文字をエンコード済みバイト シーケンスにマップします。エンコード済みバイト シーケンスは、ディスクなどの物理メディアに転送したり、通信リンクを通じて転送したりできます。文字はさまざまな方法でマップできますが、特定のエンコーディングは Encoding クラスから派生した型で表されます。具体的には、エンコードの種類の GetBytes メソッドは文字をバイト シーケンスにエンコードし、GetChars メソッドはバイト シーケンスを文字にデコードします。

しかし、入力バイト シーケンスがエンコーディングによってマップできない場合、デコード処理は失敗する可能性があります。たとえば、ASCIIEncoding オブジェクトは、コード ポイント値が U+0000 から U+007F の範囲外にある文字のバイト シーケンスをデコードできません。

エンコーディングまたはデコードによる変換が実行できない場合のために、.NET Framework では、フォールバックと呼ばれるエラー処理機構が用意されています。コードでは、定義済みの .NET Framework のエンコーダ フォールバックとデコーダ フォールバックを使用することも、EncoderFallback クラスおよび EncoderFallbackBuffer クラスから派生させたカスタムのエンコーダ フォールバック、または DecoderFallback クラスおよび DecoderFallbackBuffer クラスから派生させたカスタムのデコーダ フォールバックを作成することもできます。

.NET Framework では、デコード変換エラーを処理するため、異なるフォールバック方法を実装する 2 つの定義済みクラスが用意されています。DecoderReplacementFallback クラスは、変換できない入力バイト シーケンスの代わりに使用する文字列を作成します。代替文字列の作成後、デコード処理は、残りの入力の変換を引き続き実行します。一方、DecoderExceptionFallback クラスは、無効なバイト シーケンスを検出すると、DecoderFallbackException をスローします。

継承階層

System.Object
  System.Text.DecoderFallback
     System.Text.DecoderExceptionFallback
     System.Text.DecoderReplacementFallback

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DecoderFallback メンバ
System.Text 名前空間
DecoderReplacementFallback
DecoderExceptionFallback クラス