DllImportAttribute.ThrowOnUnmappableChar フィールド

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

DllImportAttribute.ThrowOnUnmappableChar フィールド

マップできない Unicode 文字 (ANSI の "?" に変換される文字) が見つかったときに、例外をスローするかどうかを指定します。

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

Visual Basic (宣言)

Public ThrowOnUnmappableChar As Boolean

Visual Basic (使用法)

Dim instance As DllImportAttribute
Dim value As Boolean

value = instance.ThrowOnUnmappableChar

instance.ThrowOnUnmappableChar = value

C#

public bool ThrowOnUnmappableChar

C++

public:
bool ThrowOnUnmappableChar

J#

public boolean ThrowOnUnmappableChar

JScript

public var ThrowOnUnmappableChar : boolean

解説

true の場合は、マップできない文字を相互運用マーシャラが変換するたびに例外がスローされます。false の場合は、ThrowOnUnmappableChar フィールドが無効になります。このフィールドの既定値は false です。

Windows 98 または Windows Me で実行するアンマネージ メソッドにマネージ Unicode 文字が渡された場合、このような Unicode 文字は共通言語ランタイムによって ANSI 文字に変換されます。最適マッピングを使用すると、完全一致が存在しないときに、相互運用マーシャリングが最も近い文字を提供します。たとえば、マーシャラは、ANSI 文字を許可するアンマネージ メソッドの場合、Unicode の著作権記号を 'c' に変換します。一部の文字には最適形式が存在しません。このような文字はマップできない文字といいます。マップできない文字は原則として、既定の '?'ANSI 文字に変換されます。

注意
特定の Unicode 文字は、意図せずパスを変更するおそれがある円記号 "\" など、危険な文字に変換されます。ThrowOnUnmappableChar フィールドを true に設定すると、マップできない文字があることを例外をスローして呼び出し元に通知できます。

注意
アンマネージ セーフ配列への LPSTR または ANSI Chars が要素となっているマネージ配列を渡す場合は、BestFitMapping フィールドと ThrowOnUnmappableChar フィールドの既定値を変更できません。最適マッピングは常に有効となり、例外はスローされません。この組み合わせの場合、セキュリティ モデルが損なわれるおそれがあります。

使用例

場合によっては、Visual Basic の開発者は、マネージ コードで DLL 関数を定義する際、Declare ステートメントを使用する代わりに、DllImportAttribute を使用します。ThrowOnUnmappableChar フィールドの設定は、このような事例の 1 つです。ANSI 文字セットを指定することによって最も厳しい文字マッピング セキュリティをプラットフォーム呼び出しメソッドの定義に適用し、最適マッピングの動作を無効にし、マップできない Unicode 文字に遭遇したときに例外をスローさせる例を次に示します。

Visual Basic

<DllImport("My.dll", CharSet := CharSet.Ansi, _
                       BestfitMapping := False _
                       ThrowOnUnmappableChar := True)>

C#

[DllImport("My.dll", CharSet = CharSet.Ansi, 
                       BestfitMapping = false
                       ThrowOnUnmappableChar = true)]

プラットフォーム

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、1.1

参照

関連項目
DllImportAttribute クラス
DllImportAttribute メンバ
System.Runtime.InteropServices 名前空間
CharSet
BestFitMapping