문자 집합 지정

  • 아티클

DllImportAttribute.CharSet 필드는 문자열 마샬링을 제어하고 플랫폼 호출이 DLL에서 함수 이름을 찾는 방법을 결정합니다. 이 항목에서는 두 동작에 대해 모두 설명합니다.

일부 API는 문자열 인수를 사용하는 함수의 두 가지 버전인 narrow(ANSI) 및 wide(Unicode)를 내보냅니다. 예를 들어 Windows API에는 MessageBox 함수에 대한 다음 진입점 이름이 포함됩니다.

  • MessageBoxA

    진입점 이름에 “A”를 추가하여 구분되는 1바이트 문자 ANSI 형식을 제공합니다. MessageBoxA 호출은 항상 문자열을 ANSI 형식으로 마샬링합니다.

  • MessageBoxW

    진입점 이름에 “W”를 추가하여 구분되는 2바이트 문자 유니코드 형식을 제공합니다. MessageBoxW 호출은 항상 문자열을 유니코드 형식으로 마샬링합니다.

문자열 마샬링 및 이름 일치

CharSet 필드는 다음 값을 허용합니다.

Ansi(기본값)

  • 문자열 마샬링

    플랫폼 호출은 관리되는 형식(유니코드)의 문자열을 ANSI 형식으로 마샬링합니다.

  • 이름 일치

    DllImportAttribute.ExactSpelling 필드가 Visual Basic의 기본값인 true이면 플랫폼 호출이 지정한 이름만 검색합니다. 예를 들어 MessageBox를 지정하는 경우 플랫폼 호출은 MessageBox를 검색하고, 정확한 철자를 찾을 수 없으면 실패합니다.

    ExactSpelling 필드가 C++ 및 C#의 기본값인 false이면 플랫폼 호출은 올바른 별칭(MessageBox)을 먼저 검색한 다음, 올바른 별칭을 찾을 수 없는 경우 잘못된 이름(MessageBoxA)을 검색합니다. ANSI 이름 일치 동작은 유니코드 이름 일치 동작과 다릅니다.

Unicode

  • 문자열 마샬링

    플랫폼 호출은 관리되는 형식(유니코드)의 문자열을 유니코드 형식으로 복사합니다.

  • 이름 일치

    ExactSpelling 필드가 Visual Basic의 기본값인 true이면 플랫폼 호출이 지정한 이름만 검색합니다. 예를 들어 MessageBox를 지정하는 경우 플랫폼 호출은 MessageBox를 검색하고, 정확한 철자를 찾을 수 없으면 실패합니다.

    ExactSpelling 필드가 C++ 및 C#의 기본값인 false이면 플랫폼 호출은 잘못된 이름(MessageBoxW)을 먼저 검색한 다음, 잘못된 이름을 찾을 수 없는 경우 올바른 별칭(MessageBox)을 검색합니다. 유니코드 이름 일치 동작은 ANSI 이름 일치 동작과 다릅니다.

Auto

  • 플랫폼 호출이 대상 플랫폼에 따라 런타임에 ANSI와 유니코드 중에서 선택합니다.

Visual Basic에서 문자 집합 지정

Ansi, Unicode 또는 Auto 키워드를 선언문에 추가하여 Visual Basic에서 문자 집합 동작을 지정할 수 있습니다. 문자 집합 키워드를 생략하면 DllImportAttribute.CharSet 필드는 기본적으로 ANSI 문자 집합으로 설정됩니다.

다음 예제에서는 매번 서로 다른 문자 집합 동작을 사용하여 MessageBox 함수를 세 번 선언합니다. 첫 번째 문은 문자 집합 키워드를 생략하므로 문자 집합이 기본적으로 ANSI로 설정됩니다. 두 번째 문과 세 번째 문은 키워드를 사용해서 명시적으로 문자 집합을 지정합니다.

Friend Class NativeMethods
    Friend Declare Function MessageBoxA Lib "user32.dll" (
        ByVal hWnd As IntPtr,
        ByVal lpText As String,
        ByVal lpCaption As String,
        ByVal uType As UInteger) As Integer

    Friend Declare Unicode Function MessageBoxW Lib "user32.dll" (
        ByVal hWnd As IntPtr,
        ByVal lpText As String,
        ByVal lpCaption As String,
        ByVal uType As UInteger) As Integer

    Friend Declare Auto Function MessageBox Lib "user32.dll" (
        ByVal hWnd As IntPtr,
        ByVal lpText As String,
        ByVal lpCaption As String,
        ByVal uType As UInteger) As Integer
End Class

C# 및 C++에서 문자 집합 지정

DllImportAttribute.CharSet 필드는 기본 문자 집합을 ANSI 또는 유니코드로 식별합니다. 문자 집합은 메서드에 대한 문자열 인수를 마샬링하는 방법을 제어합니다. 다음 형식 중 하나를 사용하여 문자 집합을 나타냅니다.

[DllImport("DllName", CharSet = CharSet.Ansi)]
[DllImport("DllName", CharSet = CharSet.Unicode)]
[DllImport("DllName", CharSet = CharSet.Auto)]

[DllImport("DllName", CharSet = CharSet::Ansi)]
[DllImport("DllName", CharSet = CharSet::Unicode)]
[DllImport("DllName", CharSet = CharSet::Auto)]

다음 예제에서는 문자 집합을 지정하는 MessageBox 함수의 세 가지 관리되는 정의를 보여 줍니다. 첫 번째 정의에서는 생략에 의해 CharSet 필드가 기본값인 ANSI 문자 집합으로 설정됩니다.

using System;
using System.Runtime.InteropServices;

internal static class NativeMethods
{
    [DllImport("user32.dll")]
    internal static extern int MessageBoxA(
        IntPtr hWnd, string lpText, string lpCaption, uint uType);

    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    internal static extern int MessageBoxW(
        IntPtr hWnd, string lpText, string lpCaption, uint uType);

    [DllImport("user32.dll", CharSet = CharSet.Auto)]
    internal static extern int MessageBox(
        IntPtr hWnd, string lpText, string lpCaption, uint uType);
}

typedef void* HWND;

// Can use MessageBox or MessageBoxA.
[DllImport("user32")]
extern "C" int MessageBox(
    HWND hWnd, String* lpText, String* lpCaption, unsigned int uType);

// Can use MessageBox or MessageBoxW.
[DllImport("user32", CharSet = CharSet::Unicode)]
extern "C" int MessageBoxW(
    HWND hWnd, String* lpText, String* lpCaption, unsigned int uType);

// Must use MessageBox.
[DllImport("user32", CharSet = CharSet::Auto)]
extern "C" int MessageBox(
    HWND hWnd, String* lpText, String* lpCaption, unsigned int uType);

참고 항목