Decoder.Fallback

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

Decoder.Fallback プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在の Decoder オブジェクトの DecoderFallback オブジェクトを取得または設定します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Property Fallback As
 DecoderFallback

Visual Basic (使用法)

Dim instance As Decoder
Dim value As DecoderFallback

value = instance.Fallback

instance.Fallback = value

C#

[ComVisibleAttribute(false)] 
public DecoderFallback Fallback { get; set;
 }

C++

[ComVisibleAttribute(false)] 
public:
property DecoderFallback^ Fallback {
    DecoderFallback^ get ();
    void set (DecoderFallback^ value);
}

J#

/** @property */
public DecoderFallback get_Fallback ()

/** @property */
public void set_Fallback (DecoderFallback value)

JScript

public function get Fallback
 () : DecoderFallback

public function set Fallback
 (value : DecoderFallback)

プロパティ値
DecoderFallback オブジェクト。

例外

例外の種類	条件
ArgumentNullException	設定操作の値が null 参照 (Visual Basic では Nothing) です。
ArgumentException	現在の DecoderFallbackBuffer オブジェクトにまだデコードされていないデータが含まれるため、設定操作に新しい値を代入できません。

解説

DecoderFallback オブジェクトは、エンコード済みバイト シーケンスを文字に変換できない場合に呼び出されるエラー ハンドラを表します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
Decoder クラス
Decoder メンバ
System.Text 名前空間
EncoderFallback
FallbackBuffer

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 クラス

DecoderFallback コンストラクタ

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

DecoderFallback クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New DecoderFallback

C#

protected DecoderFallback ()

C++

protected:
DecoderFallback ()

J#

protected DecoderFallback ()

JScript

protected function DecoderFallback ()

プラットフォーム

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 クラス
DecoderFallback メンバ
System.Text 名前空間

DecoderFallback プロパティ

パブリック プロパティ

	名前	説明
	ExceptionFallback	入力バイト シーケンスをデコードできないときに例外をスローするオブジェクトを取得します。
	ReplacementFallback	デコードできない入力バイト シーケンスの代わりに代替文字列を出力するオブジェクトを取得します。

参照

関連項目

DecoderFallback クラス
System.Text 名前空間
DecoderReplacementFallback
DecoderExceptionFallback クラス

DecoderFallback メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateFallbackBuffer	派生クラスでオーバーライドされた場合、DecoderFallbackBuffer クラスの新しいインスタンスを初期化します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

DecoderFallback クラス
System.Text 名前空間
DecoderReplacementFallback
DecoderExceptionFallback クラス

DecoderFallback メンバ

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

DecoderFallback データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	DecoderFallback	DecoderFallback クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ExceptionFallback	入力バイト シーケンスをデコードできないときに例外をスローするオブジェクトを取得します。
	ReplacementFallback	デコードできない入力バイト シーケンスの代わりに代替文字列を出力するオブジェクトを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CreateFallbackBuffer	派生クラスでオーバーライドされた場合、DecoderFallbackBuffer クラスの新しいインスタンスを初期化します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

DecoderFallback クラス
System.Text 名前空間
DecoderReplacementFallback
DecoderExceptionFallback クラス