Encoder.Fallback

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

Encoder.Fallback プロパティ

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As Encoder
Dim value As EncoderFallback

value = instance.Fallback

instance.Fallback = value

C#

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

C++

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

J#

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

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

JScript

public function get Fallback
 () : EncoderFallback

public function set Fallback
 (value : EncoderFallback)

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

例外

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

解説

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

プラットフォーム

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

参照

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

EncoderFallback クラス

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

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

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

Visual Basic (宣言)

<SerializableAttribute> _
Public MustInherit Class
 EncoderFallback

Visual Basic (使用法)

Dim instance As EncoderFallback

C#

[SerializableAttribute] 
public abstract class EncoderFallback

C++

[SerializableAttribute] 
public ref class EncoderFallback abstract

J#

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

JScript

SerializableAttribute 
public abstract class EncoderFallback

解説

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

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

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

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

継承階層

System.Object
  System.Text.EncoderFallback
     System.Text.EncoderExceptionFallback
     System.Text.EncoderReplacementFallback

スレッド セーフ

この型の 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

参照

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

EncoderFallback コンストラクタ

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

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

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New EncoderFallback

C#

protected EncoderFallback ()

C++

protected:
EncoderFallback ()

J#

protected EncoderFallback ()

JScript

protected function EncoderFallback ()

プラットフォーム

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

参照

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

EncoderFallback プロパティ

パブリック プロパティ

	名前	説明
	ExceptionFallback	入力文字をエンコードできない場合に例外をスローする EncoderFallback オブジェクトを取得します。
	ReplacementFallback	エンコードできない入力文字の代わりに代替文字列を作成する EncoderFallback オブジェクトを取得します。

参照

関連項目

EncoderFallback クラス
System.Text 名前空間
EncoderReplacementFallback
EncoderExceptionFallback クラス

EncoderFallback メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

EncoderFallback クラス
System.Text 名前空間
EncoderReplacementFallback
EncoderExceptionFallback クラス

EncoderFallback メンバ

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

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

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

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

パブリック プロパティ

	名前	説明
	ExceptionFallback	入力文字をエンコードできない場合に例外をスローする EncoderFallback オブジェクトを取得します。
	ReplacementFallback	エンコードできない入力文字の代わりに代替文字列を作成する EncoderFallback オブジェクトを取得します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

EncoderFallback クラス
System.Text 名前空間
EncoderReplacementFallback
EncoderExceptionFallback クラス