문자 집합 지정
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 이름 일치 동작은 유니코드 이름 일치 동작과 다릅니다.
문자열 마샬링
플랫폼 호출은 관리되는 형식(유니코드)의 문자열을 유니코드 형식으로 복사합니다.
이름 일치
ExactSpelling필드가 Visual Basic의 기본값인true이면 플랫폼 호출이 지정한 이름만 검색합니다. 예를 들어 MessageBox를 지정하는 경우 플랫폼 호출은 MessageBox를 검색하고, 정확한 철자를 찾을 수 없으면 실패합니다.ExactSpelling필드가 C++ 및 C#의 기본값인false이면 플랫폼 호출은 잘못된 이름(MessageBoxW)을 먼저 검색한 다음, 잘못된 이름을 찾을 수 없는 경우 올바른 별칭(MessageBox)을 검색합니다. 유니코드 이름 일치 동작은 ANSI 이름 일치 동작과 다릅니다.
- 플랫폼 호출이 대상 플랫폼에 따라 런타임에 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);
참고 항목
.NET