Microsoft Office Word 또는 Microsoft Office Excel에 대한 문서 수준 사용자 지정의 일부인 문서에서 VBA(Visual Basic for Applications) 코드를 사용할 수 있습니다. 사용자 지정 어셈블리에서 문서의 VBA 코드를 호출하거나 사용자 지정 어셈블리의 코드를 호출하도록 문서의 VBA 코드를 사용하도록 프로젝트를 구성할 수 있습니다.
적용 대상: 이 항목의 정보는 Excel 및 Word용 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 유형에서 사용할 수 있는 기능을 참조하세요.
문서 수준 사용자 지정에서 VBA 코드의 동작
Visual Studio에서 프로젝트를 열면 문서가 디자인 모드로 열립니다. 문서가 디자인 모드일 때 VBA 코드가 실행되지 않으므로 VBA 코드를 실행하지 않고 문서 및 코드에서 작업할 수 있습니다.
솔루션을 실행하면 VBA와 사용자 지정 어셈블리 모두에서 이벤트 처리기가 문서에서 발생하는 이벤트를 선택하고 두 코드 집합이 모두 실행됩니다. 어떤 코드가 다른 코드 앞에 실행될지는 미리 확인할 수 없습니다. 각 개별 사례에서 테스트를 통해 이를 결정해야 합니다. 두 코드 집합이 신중하게 조정되고 테스트되지 않은 경우 예기치 않은 결과를 얻을 수 있습니다.
사용자 지정 어셈블리에서 VBA 코드 호출
Word 문서에서 매크로를 호출할 수 있으며 Excel 통합 문서에서 매크로 및 함수를 호출할 수 있습니다. 이렇게 하려면 다음 방법 중 하나를 사용하세요.
Word의 경우 Application 클래스의 Run 메서드를 호출합니다.
Excel의 경우 Application 클래스의 Run 메서드를 호출합니다.
각 메서드에 대해 첫 번째 매개 변수는 호출하려는 매크로 또는 함수의 이름을 식별하고 나머지 선택적 매개 변수는 매크로 또는 함수에 전달할 매개 변수를 지정합니다. 첫 번째 매개 변수는 Word 및 Excel에 대해 다른 형식을 가질 수 있습니다.
Word의 경우 첫 번째 매개 변수는 템플릿, 모듈 및 매크로 이름의 조합일 수 있는 문자열입니다. 문서 이름을 지정하는 경우, 코드는 현재 컨텍스트와 관련된 문서에서만 매크로를 실행할 수 있으며, 임의의 문서에서는 매크로를 실행할 수 없습니다.
Excel의 경우 첫 번째 매개 변수는 매크로 이름을 지정하는 문자열, Range 함수의 위치를 나타내는 문자열 또는 등록된 DLL(XLL) 함수의 레지스터 ID일 수 있습니다. 문자열을 전달하면 문자열이 활성 시트의 컨텍스트에서 평가됩니다.
다음 코드 예제에서는 Excel용 문서 수준 프로젝트에서 명명된
MyMacro매크로를 호출하는 방법을 보여줍니다. 이 예제에서는MyMacro이(가)Sheet1에 정의되어 있다고 가정합니다.
Globals.Sheet1.Application.Run("MyMacro", missing, missing, missing,
missing, missing, missing, missing, missing, missing, missing,
missing, missing, missing, missing, missing, missing, missing,
missing, missing, missing, missing, missing, missing, missing,
missing, missing, missing, missing, missing, missing);
비고
Visual C#의 선택적 매개 변수 대신 전역 missing 변수를 사용하는 방법에 대한 자세한 내용은 Office 솔루션의 코드 작성을 참조하세요.
VBA에서 문서 수준 사용자 지정의 코드 호출
문서의 VBA(Visual Basic for Applications) 코드가 사용자 지정 어셈블리의 코드를 호출할 수 있도록 Word 또는 Excel용 문서 수준 프로젝트를 구성할 수 있습니다. 이는 다음 시나리오에서 유용합니다.
동일한 문서와 연결된 문서 수준 사용자 지정의 기능을 사용하여 문서의 기존 VBA 코드를 확장하려고 합니다.
문서에서 VBA 코드를 작성하여 서비스에 액세스할 수 있는 최종 사용자가 문서 수준 사용자 지정에서 개발하는 서비스를 사용할 수 있도록 만들려고 합니다.
Visual Studio의 Office 개발 도구는 VSTO 추가 기능에 유사한 기능을 제공합니다. VSTO 추가 기능을 개발하는 경우 다른 Microsoft Office 솔루션에서 VSTO 추가 기능의 코드를 호출할 수 있습니다. 자세한 내용은 다른 Office 솔루션의 VSTO 추가 기능에서 코드 호출을 참조하세요.
비고
이 기능은 Word 서식 파일 프로젝트에서 사용할 수 없습니다. Word 문서, Excel 통합 문서 또는 Excel 서식 파일 프로젝트에서만 사용할 수 있습니다.
요구 사항
VBA 코드를 사용하여 사용자 지정 어셈블리를 호출하도록 설정하려면 먼저 프로젝트가 다음 요구 사항을 충족해야 합니다.
문서에는 다음 파일 이름 확장명 중 하나가 있어야 합니다.
Word: .docm 또는 .doc
Excel: .xlsm, .xltm, .xls또는 .xlt
문서에 VBA 코드가 있는 VBA 프로젝트가 이미 포함되어 있어야 합니다.
사용자에게 매크로를 사용하도록 설정하라는 메시지를 표시하지 않고 문서의 VBA 코드를 실행할 수 있어야 합니다. Word 또는 Excel에 대한 보안 센터 설정의 신뢰할 수 있는 위치 목록에 Office 프로젝트의 위치를 추가하여 실행할 VBA 코드를 신뢰할 수 있습니다.
Office 프로젝트에는 VBA에 노출하는 하나 이상의 공용 멤버가 포함된 공용 클래스가 하나 이상 포함되어야 합니다.
메서드, 속성 및 이벤트를 VBA에 노출할 수 있습니다. 사용자가 노출하는 클래스는 호스트 항목 클래스(예:
ThisDocumentWord 또는 Excel용) 또는ThisWorkbookSheet1프로젝트에서 정의하는 다른 클래스일 수 있습니다. 호스트 항목에 대한 자세한 내용은 호스트 항목 및 호스트 컨트롤 개요를 참조하세요.
사용자 지정 어셈블리를 호출하도록 VBA 코드 사용
사용자 지정 어셈블리의 멤버를 문서의 VBA 코드에 노출할 수 있는 두 가지 방법이 있습니다.
Visual Basic 프로젝트의 호스트 항목 클래스 멤버를 VBA에 노출할 수 있습니다. 이렇게 하려면 호스트 항목(즉, 문서, 워크시트 또는 통합 문서)이 디자이너에서 열려 있는 동안 속성 창에서 호스트 항목의 EnableVbaCallers 속성을 True로 설정합니다. Visual Studio는 VBA 코드가 클래스의 멤버를 호출할 수 있도록 하는 데 필요한 모든 작업을 자동으로 수행합니다.
Visual C# 프로젝트의 모든 공용 클래스의 멤버 또는 Visual Basic 프로젝트의 호스트가 아닌 항목 클래스의 멤버를 VBA에 노출할 수 있습니다. 이 옵션을 사용하면 VBA에 노출하는 클래스를 자유롭게 선택할 수 있지만 더 많은 수동 단계가 필요합니다.
이렇게 하려면 다음 주요 단계를 수행해야 합니다.
COM에 클래스를 노출합니다.
프로젝트에서 호스트 항목 클래스의 GetAutomationObject 메서드를 재정의하여 VBA에 노출하는 클래스의 인스턴스를 반환합니다.
프로젝트에서 호스트 항목 클래스의 ReferenceAssemblyFromVbaProject 속성을 True로 설정합니다. 이렇게 하면 사용자 지정 어셈블리의 형식 라이브러리가 어셈블리에 포함되고 형식 라이브러리에 대한 참조를 문서의 VBA 프로젝트에 추가합니다.
자세한 지침은 방법: Visual Basic 프로젝트에서 VBA에 코드 노출 및 방법: Visual C# 프로젝트에서 VBA에 코드 노출을 참조하세요.
EnableVbaCallers 및 ReferenceAssemblyFromVbaProject 속성은 디자인 타임에 속성 창에서만 사용할 수 있습니다. 런타임에 사용할 수 없습니다. 속성을 보려면 Visual Studio에서 호스트 항목에 대한 디자이너를 엽니다. 이러한 속성을 설정할 때 Visual Studio에서 수행하는 특정 작업에 대한 자세한 내용은 호스트 항목 속성에서 수행하는 작업을 참조하세요.
비고
통합 문서 또는 문서에 VBA 코드가 아직 포함되어 있지 않거나 문서의 VBA 코드를 실행할 수 없는 경우 EnableVbaCallers 또는 ReferenceAssemblyFromVbaProject 속성을 True로 설정하면 오류 메시지가 표시됩니다. Visual Studio가 이 상황에서 문서에서 VBA 프로젝트를 수정할 수 없기 때문입니다.
VBA 코드의 멤버를 사용하여 사용자 지정 어셈블리 호출
VBA 코드가 사용자 지정 어셈블리를 호출할 수 있도록 프로젝트를 구성한 후 Visual Studio는 문서의 VBA 프로젝트에 다음 멤버를 추가합니다.
모든 프로젝트에 대해 Visual Studio는 이름이 인
GetManagedClass전역 메서드를 추가합니다.EnableVbaCallers 속성을 사용하여 호스트 항목 클래스의 멤버를 노출하는 Visual Basic 프로젝트의 경우 Visual Studio는 VBA 프로젝트의 ,
CallVSTOAssembly,ThisDocumentThisWorkbook또는Sheet1모듈에 명명된Sheet2Sheet3속성도 추가합니다.CallVSTOAssembly속성 또는GetManagedClass메서드를 사용하여 프로젝트에서 VBA 코드에 노출한 클래스의 공용 멤버에 액세스할 수 있습니다.
비고
솔루션을 개발하고 배포하는 동안 VBA 코드를 추가할 수 있는 문서의 여러 복사본이 있습니다. 자세한 내용은 문서에 VBA 코드를 추가하기 위한 지침을 참조하세요.
Visual Basic 프로젝트에서 CallVSTOAssembly 속성 사용
호스트 항목 클래스에 CallVSTOAssembly 추가한 공용 멤버에 액세스하려면 이 속성을 사용합니다. 예를 들어, 다음 VBA 매크로는 Excel 통합 문서 프로젝트의 Sheet1 클래스에 정의된 MyVSTOMethod 메서드를 호출합니다.
Sub MyMacro()
Sheet1.CallVSTOAssembly.MyVSTOMethod()
End Sub
이 속성은 메서드를 직접 사용하는 GetManagedClass 것보다 사용자 지정 어셈블리를 호출하는 더 편리한 방법입니다.
CallVSTOAssembly 는 VBA에 노출한 호스트 항목 클래스를 나타내는 개체를 반환합니다. 반환된 개체의 멤버 및 메서드 매개 변수가 IntelliSense에 표시됩니다.
속성에는 CallVSTOAssembly 다음 코드와 유사한 선언이 있습니다. 이 코드는 Sheet1 호스트 항목 클래스를 VBA에 노출한 ExcelWorkbook1라는 이름의 Excel 통합 문서 프로젝트에 대한 가정입니다.
Property Get CallVSTOAssembly() As ExcelWorkbook1.Sheet1
Set CallVSTOAssembly = GetManagedClass(Me)
End Property
GetManagedClass 메서드 사용
전역 GetManagedClass 메서드를 사용하려면 GetAutomationObject 메서드의 재정의를 포함하는 호스트 항목 클래스에 해당하는 VBA 개체를 전달합니다. 그런 다음 반환된 개체를 사용하여 VBA에 노출한 클래스에 액세스합니다.
예를 들어, 다음 VBA 매크로는 ExcelWorkbook1라는 Excel 통합 문서 프로젝트의 호스트 항목 클래스에 정의된 MyVSTOMethod 메서드를 호출합니다.
Sub CallVSTOMethod
Dim VSTOSheet1 As ExcelWorkbook1.Sheet1
Set VSTOSheet1 = GetManagedClass(Sheet1)
VSTOSheet1.MyVSTOMethod
End Sub
메서드에는 GetManagedClass 다음 선언이 있습니다.
GetManagedClass(pdispInteropObject Object) As Object
이 메서드는 VBA에 노출한 클래스를 나타내는 개체를 반환합니다. 반환된 개체의 멤버 및 메서드 매개 변수가 IntelliSense에 표시됩니다.
문서에 VBA 코드를 추가하기 위한 지침
문서 수준 사용자 지정에 호출하는 VBA 코드를 추가할 수 있는 문서의 여러 복사본이 있습니다.
솔루션을 개발하고 테스트할 때 Visual Studio에서 프로젝트를 디버그하거나 실행하는 동안 열리는 문서에 VBA 코드를 작성할 수 있습니다(즉, 빌드 출력 폴더의 문서). 그러나 Visual Studio는 빌드 출력 폴더의 문서를 기본 프로젝트 폴더의 문서 복사본으로 바꾸기 때문에 다음에 프로젝트를 빌드할 때 이 문서에 추가하는 모든 VBA 코드를 덮어씁니다.
솔루션을 디버깅하거나 실행하는 동안 문서에 추가한 VBA 코드를 저장하려면 VBA 코드를 프로젝트 폴더의 문서에 복사합니다. 빌드 프로세스에 대한 자세한 내용은 Office 솔루션 빌드를 참조하세요.
솔루션을 배포할 준비가 되면 VBA 코드를 추가할 수 있는 세 가지 기본 문서 위치가 있습니다.
개발 컴퓨터의 프로젝트 폴더 안에
이 위치는 문서의 VBA 코드와 사용자 지정 코드를 모두 완벽하게 제어할 수 있는 경우에 편리합니다. 문서가 개발 컴퓨터에 있으므로 사용자 지정 코드를 변경하는 경우 VBA 코드를 쉽게 수정할 수 있습니다. 이 문서 복사본에 추가하는 VBA 코드는 솔루션을 빌드, 디버그 및 게시할 때 문서에 남아 있습니다.
디자이너에서 열려 있는 동안에는 문서에 VBA 코드를 추가할 수 없습니다. 먼저 디자이너에서 문서를 닫은 다음 Word 또는 Excel에서 직접 문서를 열어야 합니다.
주의
문서를 열 때 실행되는 VBA 코드를 추가하는 경우 드문 경우이지만 이 코드는 문서를 손상하거나 디자이너에서 열지 못할 수 있습니다.
게시 또는 설치 폴더에서
경우에 따라 게시 또는 설치 폴더의 문서에 VBA 코드를 추가하는 것이 적합할 수 있습니다. 예를 들어 Visual Studio가 설치되지 않은 컴퓨터에서 다른 개발자가 VBA 코드를 작성하고 테스트하는 경우 이 옵션을 선택할 수 있습니다.
사용자가 게시 폴더에서 직접 솔루션을 설치하는 경우 솔루션을 게시할 때마다 문서에 VBA 코드를 추가해야 합니다. Visual Studio는 솔루션을 게시할 때 게시 위치에 있는 문서를 덮어씁니다.
사용자가 게시 폴더와 다른 설치 폴더에서 솔루션을 설치하는 경우 솔루션을 게시할 때마다 문서에 VBA 코드를 추가하지 않도록 방지할 수 있습니다. 게시 업데이트를 게시 폴더에서 설치 폴더로 이동할 준비가 되면 문서를 제외한 모든 파일을 설치 폴더에 복사합니다.
최종 사용자 컴퓨터에서
최종 사용자가 문서 수준 사용자 지정에서 제공하는 서비스를 호출하는 VBA 개발자인 경우 문서 복사본의 속성 또는 CallVSTOAssembly 메서드를 사용하여 GetManagedClass 코드를 호출하는 방법을 알려줄 수 있습니다. 솔루션에 업데이트를 게시하면 게시 업데이트로 문서가 수정되지 않으므로 최종 사용자 컴퓨터의 문서에 있는 VBA 코드를 덮어쓰지 않습니다.
호스트 항목 속성에서 수행하는 작업
EnableVbaCallers 및 ReferenceAssemblyFromVbaProject 속성을 사용하는 경우 Visual Studio는 다양한 작업 집합을 수행합니다.
VBA 호출자 활성화 (EnableVbaCallers)
Visual Basic 프로젝트에서 호스트 항목의 EnableVbaCallers 속성을 True 로 설정하면 Visual Studio에서 다음 작업을 수행합니다.
호스트 항목 클래스에 ComClassAttribute 특성 및 ComVisibleAttribute 특성을 추가합니다.
호스트 항목 클래스의 GetAutomationObject 메서드를 재정의합니다.
호스트 항목의 ReferenceAssemblyFromVbaProject 속성을 True로 설정합니다.
EnableVbaCallers 속성을 다시 False로 설정하면 Visual Studio에서 다음 작업을 수행합니다.
클래스에서 ComClassAttributeComVisibleAttribute 특성 및
ThisDocument특성을 제거합니다.호스트 항목 클래스에서 GetAutomationObject 메서드를 제거합니다.
비고
Visual Studio는 ReferenceAssemblyFromVbaProject 속성을 False로 자동으로 설정하지 않습니다. 속성 창을 사용하여 이 속성을 수동으로 False로 설정할 수 있습니다.
ReferenceAssemblyFromVbaProject
Visual Basic 또는 Visual C# 프로젝트의 호스트 항목에 대한 ReferenceAssemblyFromVbaProject 속성을 True로 설정하면 Visual Studio에서 다음 작업을 수행합니다.
사용자 지정 어셈블리에 대한 형식 라이브러리를 생성하고 어셈블리에 형식 라이브러리를 포함합니다.
문서의 VBA 프로젝트에서 다음 형식 라이브러리에 대한 참조를 추가합니다.
사용자 지정 어셈블리에 대한 형식 라이브러리입니다.
Office용 Microsoft Visual Studio 도구 실행 엔진 9.0 형식 라이브러리입니다. 이 형식 라이브러리는 Visual Studio Tools for Office 런타임에 포함되어 있습니다.
ReferenceAssemblyFromVbaProject 속성이 False로 다시 설정되면 Visual Studio에서 다음 작업을 수행합니다.
문서의 VBA 프로젝트에서 형식 라이브러리 참조를 제거합니다.
어셈블리에서 포함된 형식 라이브러리를 제거합니다.
Troubleshoot
다음 표에서는 오류를 수정하기 위한 몇 가지 일반적인 오류 및 제안을 나열합니다.
| 오류 | 제안 |
|---|---|
| EnableVbaCallers 또는 ReferenceAssemblyFromVbaProject 속성을 설정하면 문서에 VBA 프로젝트가 없거나 문서의 VBA 프로젝트에 액세스할 수 있는 권한이 없다는 오류 메시지가 표시됩니다. | 프로젝트의 문서에 하나 이상의 VBA 매크로가 포함되어 있고, VBA 프로젝트가 실행하기에 충분한 신뢰가 있고, VBA 프로젝트가 암호로 보호되지 않는지 확인합니다. |
| EnableVbaCallers 또는 ReferenceAssemblyFromVbaProject 속성을 설정한 후 선언이 GuidAttribute 누락되었거나 손상되었다는 오류 메시지가 표시됩니다. | 선언이 GuidAttribute 프로젝트의 AssemblyInfo.cs 또는 AssemblyInfo.vb 파일에 있고 이 특성이 유효한 GUID로 설정되어 있는지 확인합니다. |
| EnableVbaCallers 또는 ReferenceAssemblyFromVbaProject 속성을 설정한 후 오류 메시지에 지정된 버전 번호가 잘못되었음을 AssemblyVersionAttribute 나타냅니다. | AssemblyVersionAttribute 프로젝트의 AssemblyInfo.cs 또는 AssemblyInfo.vb 파일의 선언이 유효한 어셈블리 버전 번호로 설정되어 있는지 확인합니다. 유효한 어셈블리 버전 번호에 대한 자세한 내용은 클래스를 AssemblyVersionAttribute 참조하세요. |
| 사용자 지정 어셈블리의 이름을 바꾸면 사용자 지정 어셈블리를 호출하는 VBA 코드의 작동이 중지됩니다. | VBA 코드에 노출한 후 사용자 지정 어셈블리의 이름을 변경하면 문서의 VBA 프로젝트와 사용자 지정 어셈블리 간의 링크가 끊어집니다. 이 문제를 해결하려면 프로젝트의 ReferenceFromVbaAssembly 속성을 False 로 변경한 다음 다시 True로 변경한 다음 VBA 코드의 이전 어셈블리 이름에 대한 참조를 새 어셈블리 이름으로 바꿉니다. |