Tlbimp.exe(형식 라이브러리 가져오기)

  • 아티클

업데이트: 2011년 4월

형식 라이브러리 가져오기 도구는 COM 형식 라이브러리에 있는 형식 정의를 공용 언어 런타임 어셈블리의 동등한 정의로 변환합니다. Tlbimp.exe의 출력은 원본 형식 라이브러리에 정의된 형식의 런타임 메타데이터를 포함하는 이진 파일(어셈블리)입니다. Ildasm.exe와 같은 도구를 사용하여 이 파일을 검토할 수 있습니다.

이 도구는 Visual Studio 및 Windows SDK와 함께 자동으로 설치됩니다. 도구를 실행하려면 Visual Studio 명령 프롬프트 또는 Windows SDK 명령 프롬프트(CMD 셸)를 사용하는 것이 좋습니다. 이러한 유틸리티를 사용하면 설치 폴더를 탐색하지 않고도 도구를 쉽게 실행할 수 있습니다. 자세한 내용은 Visual Studio 및 Windows SDK 명령 프롬프트을 참조하십시오.

  • 컴퓨터에 Visual Studio를 설치한 경우 작업 표시줄에서 Start, All Programs, Visual Studio, Visual Studio Tools 및 Visual Studio Command Prompt를 차례로 클릭합니다.

    또는

    컴퓨터에 Windows SDK를 설치한 경우 작업 표시줄에서 Start, All Programs 및 Windows SDK의 폴더를 차례로 클릭한 다음 Command Prompt(또는 CMD Shell)를 클릭합니다.

  • 명령 프롬프트에 다음과 같이 입력합니다.

tlbimp tlbFile [options]

매개 변수

인수

설명

tlbFile

COM 형식 라이브러리를 포함하는 파일의 이름입니다.

Option

설명

/asmversion:versionNumber

만들 어셈블리의 버전 번호를 지정합니다. major.minor.build.revision 형식으로 versionNumber를 지정합니다.

/delaysign

Tlbimp.exe에서 지연 서명을 사용하여 강력한 이름의 결과 어셈블리에 서명하도록 지정합니다. /keycontainer:, /keyfile: 또는 /publickey: 옵션과 함께 이 옵션을 지정해야 합니다. 서명 연기 프로세스에 대한 자세한 내용은 어셈블리 서명 연기를 참조하십시오.

/help

이 도구의 명령 구문 및 옵션을 표시합니다.

/keycontainer:containername

containername에서 지정한 키 컨테이너에 있는 공개/개인 키 쌍을 사용하여 강력한 이름으로 결과 어셈블리에 서명합니다.

/keyfile:filename

filename에 있는 게시자의 공식 공개/개인 키 쌍을 사용하여 강력한 이름으로 결과 어셈블리에 서명합니다.

/namespace:네임스페이스

어셈블리를 만들 네임스페이스를 지정합니다.

/noclassmembers

Tlbimp.exe에서 클래스에 멤버를 추가하지 못하도록 합니다. 이렇게 하면 TypeLoadException이 발생하지 않습니다.

/nologo

Microsoft 시작 배너를 표시하지 않습니다.

/out:filename

메타데이터 정의를 기록할 출력 파일의 이름, 어셈블리 및 네임스페이스를 지정합니다. 형식 라이브러리에서 어셈블리의 네임스페이스를 명시적으로 제어하는 IDL(Interface Definition Language) 사용자 지정 특성을 지정하는 경우 /out 옵션은 어셈블리의 네임스페이스에 영향을 주지 않습니다. 이 옵션을 지정하지 않으면 Tlbimp.exe는 입력 파일 내에 정의한 실제 형식 라이브러리와 이름이 같은 파일에 메타데이터를 기록하고 이 파일의 확장명을 .dll로 지정합니다. 출력 파일과 입력 파일의 이름이 같은 경우 형식 라이브러를 덮어쓰지 않도록 오류가 생성됩니다.

/primary

지정된 형식 라이브러리에 대한 주 interop 어셈블리를 만듭니다. 어셈블리를 만든 형식 라이브러리의 게시자를 나타내는 정보가 어셈블리에 추가됩니다. 주 interop 어셈블리를 지정하면 게시자의 어셈블리를 Tlbimp.exe를 사용하여 형식 라이브러리에서 만든 다른 어셈블리와 구별할 수 있습니다. Tlbimp.exe를 사용하여 가져오는 형식 라이브러리의 게시자인 경우에만 /primary 옵션을 사용해야 합니다. 강력한 이름을 사용하여 주 interop 어셈블리를 서명해야 합니다. 자세한 내용은 주 interop 어셈블리를 참조하십시오.

/publickey:filename

결과 어셈블리에 서명하는 데 사용할 공개 키를 포함하는 파일을 지정합니다. /publickey: 대신 /keyfile: 또는 /keycontainer: 옵션을 지정하는 경우 Tlbimp.exe는 /keyfile: 또는 /keycontainer:에 제공된 공개/개인 키 쌍에서 공개 키를 생성합니다. /publickey: 옵션은 테스트 키 및 서명 연기 시나리오를 지원합니다. 파일은 Sn.exe에 의해 생성된 형식으로 되어 있습니다. 자세한 내용은 강력한 이름 도구(Sn.exe)에서 Sn.exe의 -p 옵션을 참조하십시오.

/reference:파일 이름

현재 형식 라이브러리 외부에 정의된 형식에 대한 참조를 확인하는 데 사용할 어셈블리 파일을 지정합니다. /reference 옵션을 지정하지 않은 경우 Tlbimp.exe는 가져오는 형식 라이브러리에서 참조하는 외부 형식 라이브러리를 재귀적으로 가져옵니다. 이 작업은 자동으로 수행됩니다. /reference 옵션을 지정한 경우 Tlbimp.exe는 다른 형식 라이브러리를 가져오기 전에 참조된 어셈블리에서 외부 형식을 확인하려고 시도합니다.

/silent

성공 메시지를 표시하지 않습니다.

/strictref

도구에서 현재 어셈블리, /reference 옵션으로 지정한 어셈블리 또는 등록된 PIA(주 Interop 어셈블리) 내의 모든 참조를 확인할 수 없는 경우 형식 라이브러리를 가져오지 않습니다.

/strictref:nopia

/strictref와 같지만 PIA를 무시합니다.

/sysarray

COM 스타일 SafeArray를 관리되는 System.Array 클래스 형식으로 가져오도록 지정합니다.

/tlbreference:파일 이름

레지스트리를 조회하지 않고 형식 라이브러리 참조를 확인하는 데 사용할 형식 라이브러리 파일을 지정합니다.

이 옵션을 사용하면 이전의 형식 라이브러리 형식 중 일부가 로드되지 않습니다. 그러나 레지스트리나 현재 디렉터리를 통해 암시적으로 이전의 형식 라이브러리 형식을 로드할 수 있습니다.

/transform:transformName

transformName 매개 변수에서 지정하는 대로 메타데이터를 변환합니다.

transformName 매개 변수에 대해 dispret를 지정하여 디스패치 전용 인터페이스(dispinterface)에 있는 메서드의 [out, retval] 매개 변수를 반환 값으로 변환합니다.

이 옵션에 대한 자세한 내용은 이 항목 뒷부분의 예제를 참조하십시오.

/unsafe

.NET Framework 보안 검사를 실행하지 않고 인터페이스를 만듭니다. 이런 식으로 노출된 메서드를 호출하면 보안상 위험할 수 있습니다. 이러한 코드 노출의 위험에 대해 잘 모르면 이 옵션을 사용하지 않는 것이 좋습니다.

/verbose

세부 정보 표시 모드를 지정합니다. 즉, 가져온 형식 라이브러리에 대한 추가 정보를 표시합니다.

/VariantBoolFieldToBool

구조 내 VARIANT_BOOL 필드를 Boolean으로 변환합니다.

/?

이 도구의 명령 구문 및 옵션을 표시합니다.
참고참고

Tlbimp.exe의 명령줄 옵션은 대/소문자를 구분하지 않으며 순서에 관계없이 지정할 수 있습니다.또한, 고유하게 식별할 수 있을 정도로만 옵션을 지정하면 됩니다.즉, /n은 /nologo와 같고 /ou:outfile.dll은 /out:outfile.dll과 같습니다.

설명

Tlbimp.exe는 한 번에 전체 형식 라이브러리 변환을 수행합니다. 이 도구를 사용하여 단일 형식 라이브러리 내에 정의된 형식의 하위 집합에 대한 형식 정보를 생성할 수는 없습니다.

어셈블리에 강력한 이름을 지정할 수 있는 기능이 유용하거나 필요할 때가 종종 있습니다. 따라서 Tlbimp.exe는 강력한 이름의 어셈블리를 생성하는 데 필요한 정보를 제공하는 옵션을 포함합니다. **/keyfile:**과 /keycontainer: 옵션 둘 다 강력한 이름으로 어셈블리에 서명합니다. 그러므로 한 번에 한 옵션만 지정하면 됩니다.

여러 개의 형식 라이브러리를 포함하는 모듈에서 형식 라이브러리를 가져오는 경우 선택적으로 리소스 ID를 형식 라이브러리 파일에 추가할 수 있습니다. 이 파일이 현재 디렉터리에 있거나 전체 경로를 지정하는 경우에만 Tlbimp.exe를 사용하여 파일을 찾을 수 있습니다. 이 항목의 뒷부분에 있는 예제를 참조하십시오.

예제

다음 명령을 사용하여 myTest.tlb에 있는 형식 라이브러리와 이름이 같고 확장명이 .dll인 어셈블리를 생성합니다.

tlbimp myTest.tlb

다음 명령을 사용하여 myTest.dll이라는 이름의 어셈블리를 생성합니다.

tlbimp  myTest.tlb  /out:myTest.dll

다음 명령을 사용하여 MyModule.dll\1 에 지정된 형식 라이브러리와 이름이 같고 확장명이 .dll인 어셈블리를 생성합니다. MyModule.dll\1 은 현재 디렉터리에 있어야 합니다.

tlbimp MyModule.dll\1

다음 명령을 사용하여 형식 라이브러리 TestLib.dll에 대해 이름이 myTestLib.dll인 어셈블리를 생성합니다. /transform:dispret 옵션은 형식 라이브러리의 dispinterface에 있는 메서드의 모든 [out, retval] 매개 변수를 관리되는 라이브러리의 반환 값으로 변환합니다.

tlbimp TestLib.dll /transform:dispret /out:myTestLib.dll

앞의 예제에서 형식 라이브러리 TestLib.dll은 void를 반환하고 [out, retval] 매개 변수를 갖는 SomeMethod라는 disinterface 메서드를 포함합니다. 다음 코드는 TestLib.dll에 있는 SomeMethod에 대한 입력 형식 라이브러리 메서드 시그니처입니다.

void SomeMethod([out, retval] VARIANT_BOOL*);

/transform:dispret 옵션을 지정하면 Tlbimp.exe는 SomeMethod의 [out, retval] 매개 변수를 bool 반환 값으로 변환합니다. 다음은 /transform:dispret 옵션이 지정될 때 관리되는 라이브러리 myTestLib.dll에 있는 SomeMethod에 대해 Tlbimp.exe가 생성하는 메서드 시그니처입니다.

bool SomeMethod();

Tlbimp.exe를 사용하여 /transform:dispret를 지정하지 않고 TestLib.dll에 대해 관리되는 라이브러리를 생성하면 관리되는 라이브러리 myTestLib.dll에서 SomeMethod에 대해 다음 메서드 시그니처가 생성됩니다.

void SomeMethod(out bool x);

참고 항목

참조

Tlbexp.exe(형식 라이브러리 내보내기)

Ildasm.exe(MSIL 디스어셈블러)

Sn.exe(강력한 이름 도구)

Visual Studio 및 Windows SDK 명령 프롬프트

개념

형식 라이브러리를 어셈블리로 가져오기

강력한 이름의 어셈블리

Interop 어셈블리로 형식 라이브러리를 가져오는 특성

기타 리소스

.NET Framework 도구

형식 라이브러리를 어셈블리로 변환 요약

변경 기록

날짜

변경 내용

이유

2011년 4월

Visual Studio 및 Windows SDK 명령 프롬프트 사용에 대한 정보를 추가했습니다.

향상된 기능 관련 정보

2010년 5월

누락된 스위치를 추가했습니다.

콘텐츠 버그 수정