다음을 통해 공유

문자 집합 지정

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

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

  • MessageBoxA

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

  • MessageBoxW

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

문자열 마샬링 및 이름 일치

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

Ansi(기본값)

  • 문자열 마샬링

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

  • 이름 일치

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

    ExactSpelling 필드가 false로 설정된 경우, C++ 및 C#에서는 플랫폼 호출이 얽히지 않은 별칭(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);

참고하십시오