DllImportAttribute.ExactSpelling フィールド

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

DllImportAttribute.ExactSpelling フィールド

DllImportAttribute.CharSet フィールドで、指定された名前以外のエントリ ポイント名をアンマネージ DLL から共通言語ランタイムに検索させるかどうかを制御します。

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

Visual Basic (宣言)

Public ExactSpelling As Boolean

Visual Basic (使用法)

Dim instance As DllImportAttribute
Dim value As Boolean

value = instance.ExactSpelling

instance.ExactSpelling = value

C#

public bool ExactSpelling

C++

public:
bool ExactSpelling

J#

public boolean ExactSpelling

JScript

public var ExactSpelling : boolean

解説

false の場合、文字 A が追加されたエントリ ポイントの名前が DllImportAttribute.CharSet フィールドを CharSet.Ansi に設定したときに呼び出され、文字 W が追加されたエントリ ポイントの名前が DllImportAttribute.CharSet フィールドを CharSet.Unicode に設定したときに呼び出されます。通常、このフィールドはマネージ コンパイラによって設定されます。

プログラミング言語が課す既定値を基に、CharSet フィールドと ExactSpelling フィールドの関係を次の表に示します。既定値はオーバーライドできますが、オーバーライドするときは慎重に行ってください。

言語	ANSI	Unicode	Auto
Visual Basic	ExactSpelling:=True	ExactSpelling:=True	ExactSpelling:=False
C#	ExactSpelling=false	ExactSpelling=false	ExactSpelling=false
C++	ExactSpelling=false	ExactSpelling=false	ExactSpelling=false

使用例

場合によっては、Visual Basic の開発者は、マネージ コードで DLL 関数を定義する際、Declare ステートメントを使用する代わりに、DllImportAttribute を使用します。ExactSpelling フィールドの設定は、このような事例の 1 つです。

Visual Basic

Imports System.Runtime.InteropServices
 Public Class Win32   
     <DllImport ("user32.dll", ExactSpelling :=
 False)> _
     Public Shared Function
 MessageBox (ByVal hWnd As Integer,
 _
         ByVal txt As String,
 ByVal caption As String,
 _
         ByVal Typ As Integer)
 As Integer
     End Function
 End Class

C#

using System.Runtime.InteropServices;
 public class Win32 {
     [DllImport("user32.dll", CharSet=CharSet.Unicode, 
                ExactSpelling=true)]
     public static extern int
 MessageBoxW(int hWnd, String text, String 
                                           caption, uint type);
 }

C++

using namespace System::Runtime::InteropServices;
 typedef void* HWND;
 [DllImport("user32", CharSet=CharSet::Ansi, ExactSpelling=true)]
 extern "C" int MessageBoxA(HWND hWnd,
                           String* pText,
                           String* pCaption,
                           unsigned int uType);

プラットフォーム

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

参照

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