DllImportAttribute.CharSet フィールドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DllImportAttribute.CharSet フィールド

文字列パラメータをメソッドにマーシャリングし、名前マングルを制御する方法を示します。

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

Visual Basic (宣言)

Public CharSet As CharSet

Visual Basic (使用法)

Dim instance As DllImportAttribute
Dim value As CharSet

value = instance.CharSet

instance.CharSet = value

public CharSet CharSet

C++

public:
CharSet CharSet

public CharSet CharSet

JScript

public var CharSet : CharSet

解説

CharSet 列挙体のメンバと併せてこのフィールドを使用すると、文字列パラメータのマーシャリング動作と、呼び出すエントリポイントの名前 (指定と厳密に一致する名前または "A" か "W" で終わる名前) を指定できます。C# および Visual Basic の既定の列挙体メンバは CharSet.Ansi です。C++ の既定の列挙体メンバは CharSet.None (CharSet.Ansi と等価) です。Visual Basic では、Declare ステートメントを使用して CharSet フィールドを指定します。

ExactSpelling フィールドによって、呼び出すエントリポイント名を判定する際の CharSet フィールドの動作が影響を受けます。CharSet フィールドに関連する文字列マーシャリングと名前一致の動作の詳細と例については、「文字セットの指定」を参照してください。

使用例

DllImportAttribute 属性を使用して Win32 MessageBox 関数をインポートする方法を次のコード例に示します。このコード例では、インポートしたメソッドを呼び出しています。

Visual Basic

Imports System
Imports System.Runtime.InteropServices

Module Example

    ' Use DllImport to import the Win32 MessageBox function.
    <DllImport("user32.dll", CharSet:=CharSet.Auto)>
 _
    Function MessageBox(ByVal hwnd As
 IntPtr, ByVal t As String,
 ByVal caption As String, ByVal t2 As UInt32) As Integer
    End Function


    Sub Main()
        ' Call the MessageBox function using platform invoke.
        MessageBox(New IntPtr(0), "Hello World!",
 "Hello Dialog", 0)
    End Sub

End Module

using System;
using System.Runtime.InteropServices;

class Example
{
    // Use DllImport to import the Win32 MessageBox function.
    [DllImport("user32.dll", CharSet = CharSet.Auto)]
    public static extern int
 MessageBox(IntPtr hWnd, String text, String caption, uint type);
    
    static void Main()
    {
        // Call the MessageBox function using platform invoke.
        MessageBox(new IntPtr(0), "Hello World!", "Hello
 Dialog", 0);
    }
}