DllImportAttribute.BestFitMapping フィールド
メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
Unicode 文字を ANSI 文字に変換するときの、最適マッピング動作のオン/オフを切り替えます。
Public BestFitMapping As Boolean
[C#]
public bool BestFitMapping;
[C++]
public: bool BestFitMapping;
[JScript]
public var BestFitMapping : Boolean;
解説
true の場合、最適マッピングは有効になります。これ以外の場合、最適マッピングは無効になります。 BestFitMapping フィールドの既定値は true です。このフィールドの設定は、 System.Runtime.InteropServices.BestFitMappingAttribute 属性のすべてのレベルの設定をオーバーライドします。
Windows 98 または Windows Me で実行するアンマネージ メソッドにマネージ Unicode 文字が渡された場合、このような Unicode 文字は共通言語ランタイムによって ANSI 文字に変換されます。最適マッピングを使用すると、完全一致が存在しないときに、 相互運用マーシャラ が最も近い文字を提供します。たとえば、マーシャラは、ANSI 文字を許可するアンマネージ メソッドの場合、Unicode の著作権記号を 'c' に変換します。一部の文字には最適形式が存在しません。このような文字はマップできない文字といいます。マップできない文字は原則として、既定の '?' ANSI 文字に変換されます。
注意 特定の Unicode 文字は、意図せずパスを変更するおそれがある円記号 "\" など、危険な文字に変換されます。 ThrowOnUnmappableChar フィールドを true に設定すると、マップできない文字があることを例外をスローして呼び出し元に通知できます。
注意 アンマネージ セーフ配列への LPSTR または ANSI Chars が要素となっているマネージ配列を渡す場合は、 BestFitMapping フィールドと ThrowOnUnmappableChar フィールドの既定値を変更できません。最適マッピングは常に有効となり、例外はスローされません。この組み合わせの場合、セキュリティ モデルが損なわれるおそれがあります。
使用例
[Visual Basic, C#] Visual Basic の開発者は、マネージ コードで DLL 関数を定義する際、 Declare ステートメントの代わりに、 DllImportAttribute を使用することがあります。 BestFitMapping フィールドの設定は、このような事例の 1 つです。ANSI 文字セットを指定することによって最も厳しい文字マッピング セキュリティをプラットフォーム呼び出しメソッドの定義に適用し、最適マッピングの動作を無効にし、マップできない Unicode 文字に遭遇したときに例外をスローさせる例を次に示します。
<DllImport( "My.dll", Charset := Charset.Ansi, _
BestfitMapping := False _
ThrowOnUnmappableChar := True )>
[C#]
[DllImport( "My.dll", Charset = Charset.Ansi,
BestfitMapping = false
ThrowOnUnmappableChar = true )]
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
DllImportAttribute クラス | DllImportAttribute メンバ | System.Runtime.InteropServices 名前空間 | CharSet | BestFitMappingAttribute