DecoderFallbackBuffer

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

Decoder.FallbackBuffer プロパティ

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

現在の Decoder オブジェクトに関連付けられている DecoderFallbackBuffer オブジェクトを取得します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public ReadOnly Property
 FallbackBuffer As DecoderFallbackBuffer

Visual Basic (使用法)

Dim instance As Decoder
Dim value As DecoderFallbackBuffer

value = instance.FallbackBuffer

C#

[ComVisibleAttribute(false)] 
public DecoderFallbackBuffer FallbackBuffer { get;
 }

C++

[ComVisibleAttribute(false)] 
public:
property DecoderFallbackBuffer^ FallbackBuffer {
    DecoderFallbackBuffer^ get ();
}

J#

/** @property */
public DecoderFallbackBuffer get_FallbackBuffer ()

JScript

public function get FallbackBuffer
 () : DecoderFallbackBuffer

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

解説

DecoderFallbackBuffer オブジェクトは、DecoderFallback オブジェクトが使用するデータを表します。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
Fallback

DecoderFallbackBuffer クラス

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

入力バイト シーケンスがデコードできない場合に、出力文字の代わりに作成される文字列をデコード処理に渡します。

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

Visual Basic (宣言)

Public MustInherit Class
 DecoderFallbackBuffer

Visual Basic (使用法)

Dim instance As DecoderFallbackBuffer

C#

public abstract class DecoderFallbackBuffer

C++

public ref class DecoderFallbackBuffer abstract

J#

public abstract class DecoderFallbackBuffer

JScript

public abstract class DecoderFallbackBuffer

解説

エンコーディングでは、Unicode 文字とエンコード済みバイト シーケンスとの間にマップを定義します。しかし、特定の文字にマップが定義されていない場合、エンコーディング処理 (入力文字の出力バイト シーケンスへの変換) やデコード処理 (入力バイト シーケンスの出力文字への変換) は失敗します。

.NET Framework には、変換を実行できない場合のために、フォールバックと呼ばれる変換エラー処理機構が用意されています。すべてのデコーダ フォールバックにデコーダ フォールバック バッファが実装されている必要があります。デコーダ フォールバック バッファは、DecoderFallbackBuffer クラスから派生した型で表され、変換処理に文字列を渡すことができます。

フォールバックでは、さまざまな方法を使用して変換エラーを処理できます。たとえば、デコーダ置換フォールバックのフォールバック バッファでは、入力バイト シーケンスがデコードできない場合に、代替出力文字列が作成されます。特定のフォールバックに実装されるエラー処理方法でデータを作成する必要がない場合でも、フォールバック バッファは必要です。たとえば、エンコーダまたはデコーダの例外フォールバックでは、出力を作成する代わりに例外をスローするため、フォールバック バッファが使用されることはありません。

継承階層

System.Object
  System.Text.DecoderFallbackBuffer
     System.Text.DecoderExceptionFallbackBuffer
     System.Text.DecoderReplacementFallbackBuffer

スレッド セーフ

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

参照

関連項目
DecoderFallbackBuffer メンバ
System.Text 名前空間

DecoderFallbackBuffer コンストラクタ

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

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

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New DecoderFallbackBuffer

C#

protected DecoderFallbackBuffer ()

C++

protected:
DecoderFallbackBuffer ()

J#

protected DecoderFallbackBuffer ()

JScript

protected function DecoderFallbackBuffer ()

プラットフォーム

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

参照

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

DecoderFallbackBuffer プロパティ

パブリック プロパティ

	名前	説明
	Remaining	派生クラスでオーバーライドされた場合、現在の DecoderFallbackBuffer オブジェクト内に処理されずに残っている文字数を取得します。

参照

関連項目

DecoderFallbackBuffer クラス
System.Text 名前空間

DecoderFallbackBuffer メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Fallback	派生クラスでオーバーライドされた場合、指定した入力バイト シーケンスを処理するためのフォールバック バッファを確保します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetNextChar	派生クラスでオーバーライドされた場合、フォールバック バッファの次の文字を取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	MovePrevious	派生クラスでオーバーライドされた場合、GetNextChar メソッドに対する次の呼び出しで、データ バッファにおける現在の文字位置の前の文字位置に移動します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Reset	このフォールバック バッファに関連するすべてのデータおよびステータス情報を初期化します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

DecoderFallbackBuffer クラス
System.Text 名前空間

DecoderFallbackBuffer メンバ

入力バイト シーケンスがデコードできない場合に、出力文字の代わりに作成される文字列をデコード処理に渡します。

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

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

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

パブリック プロパティ

	名前	説明
	Remaining	派生クラスでオーバーライドされた場合、現在の DecoderFallbackBuffer オブジェクト内に処理されずに残っている文字数を取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Fallback	派生クラスでオーバーライドされた場合、指定した入力バイト シーケンスを処理するためのフォールバック バッファを確保します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetNextChar	派生クラスでオーバーライドされた場合、フォールバック バッファの次の文字を取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	MovePrevious	派生クラスでオーバーライドされた場合、GetNextChar メソッドに対する次の呼び出しで、データ バッファにおける現在の文字位置の前の文字位置に移動します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Reset	このフォールバック バッファに関連するすべてのデータおよびステータス情報を初期化します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

DecoderFallbackBuffer クラス
System.Text 名前空間