문서 수준 사용자 지정 아키텍처
Visual Studio 2013에는 Microsoft Office Word 및 Microsoft Office Excel용 문서 수준 사용자 지정을 만들 수 있는 프로젝트가 포함되어 있습니다. 이 항목에서는 다음과 같은 문서 수준 사용자 지정의 측면에 대해 설명합니다.
사용자 지정이 Microsoft Office 애플리케이션과 작동하는 방식
적용 대상: 이 항목의 정보는 Excel 및 Word의 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.
문서 수준 사용자 지정을 만드는 방법에 대한 일반적인 내용은 Office 솔루션 개발 개요(VSTO), Word용 문서 수준 사용자 지정 프로그래밍 시작 및 Excel용 문서 수준 사용자 지정 프로그래밍 시작을 참조하세요.
사용자 지정 이해
Visual Studio에서 Office 개발자 도구를 사용하여 문서 수준 사용자 지정을 만들 때 특정 문서와 연결된 관리 코드 어셈블리를 만듭니다. 연결된 어셈블리가 있는 문서 또는 통합 문서를 관리 코드 확장이 있다고 말합니다. 자세한 내용은 Office 솔루션 디자인 및 만들기를 참조하세요.
사용자가 문서를 열면 Microsoft Office 애플리케이션에서 해당 어셈블리가 로드됩니다. 어셈블리가 로드되고 나면 문서가 열려있는 동안 사용자 지정이 이벤트에 응답할 수 있습니다. 사용자 지정은 문서가 열려 있는 동안 애플리케이션이 자동화되고 확장되도록 개체 모델을 호출할 수도 있으며 .NET Framework의 클래스 중 하나를 사용할 수 있습니다.
어셈블리는 애플리케이션의 주 interop 어셈블리를 통해 애플리케이션의 COM 구성 요소와 통신합니다. 자세한 내용은 Office 주 Interop 어셈블리 및 Office 솔루션 개발 개요(VSTO)를 참조하세요.
사용자가 동시에 여러 개의 문서 수준 사용자 지정을 여는 경우 각 어셈블리는 서로 다른 애플리케이션 도메인에 로드됩니다. 즉, 한 솔루션이 잘못 동작해도 다른 솔루션이 실패할 수 없습니다. 문서 수준 사용자 지정은 단일 애플리케이션 도메인의 단일 문서에서 작동하도록 설계된 것으로 문서 간 통신을 위해 설계되지 않았습니다. 애플리케이션 도메인에 대한 자세한 내용은 애플리케이션 도메인을 참조하세요.
참고 항목
Visual Studio에서 Office 개발자 도구를 사용하여 만든 문서 수준 사용자 지정은 최종 사용자가 애플리케이션을 시작할 때만 사용할 수 있도록 설계되었습니다. 애플리케이션이 프로그래밍 방식으로 시작되는 경우(예: 자동화를 사용하여 시작) 사용자 지정은 예상대로 작동하지 않을 수도 있습니다.
디자인 타임 및 런타임 환경
문서 수준 사용자 지정의 아키텍처를 이해하기 위해 솔루션을 디자인하고 실행하는 환경을 이해하는 것이 좋습니다.
디자인 타임
디자인 타임 환경에는 다음 단계가 포함됩니다.
개발자가 Visual Studio에서 문서 수준 프로젝트를 만듭니다. 프로젝트에는 문서 및 문서 뒤에서 실행되는 어셈블리가 포함됩니다. 문서는 이미 존재하고 있을 수 있으며(디자이너가 만듦) 프로젝트와 함께 새 문서가 생성될 수 있습니다.
디자이너(프로젝트를 만드는 개발자 또는 다른 사람)가 최종 사용자를 위한 문서의 최종 모양과 느낌을 만듭니다.
런타임
런타임 환경은 다음 단계가 포함됩니다.
최종 사용자가 관리 코드 확장이 있는 문서 또는 통합 문서를 엽니다.
문서 또는 통합 문서가 컴파일된 어셈블리를 로드합니다.
사용자가 문서 또는 통합 문서에서 작업할 때 어셈블리가 이벤트에 응답합니다.
개발자와 최종 사용자의 관점 비교
개발자는 주로 Visual Studio에서 작업하고 최종 사용자는 Word 또는 Excel에서 작업하므로 두 가지 방법으로 문서 수준 사용자 지정을 이해할 수 있습니다.
| 개발자 관점 | 최종 사용자 관점 |
|---|---|
| Visual Studio를 사용하여 개발자는 Word 및 Excel에 액세스할 수 있는 코드를 작성합니다. 비록 개발자가 Word나 Excel을 실행하는 실행 파일을 만드는 것처럼 보이기는 하지만 실제로 프로세스가 작동하는 방식은 그와 반대입니다. 문서는 어셈블리와 연결되어 있고 해당 어셈블리에 대한 포인터를 포함하고 있습니다. 문서가 열리면 Word나 Excel이 어셈블리를 찾고, 처리된 모든 이벤트에 대한 응답으로 코드를 실행합니다. |
솔루션을 사용하는 사용자는 단지 다른 Microsoft Office 파일을 여는 것처럼 문서 또는 통합 문서를 열거나 아니면 템플릿에서 새 문서를 만듭니다. 어셈블리는 문서나 통합 문서에서 사용자 지정(예: 자동으로 현재 데이터를 채우거나 정보를 요청하는 대화 상자 보여 주기)을 제공합니다. |
문서 수준 사용자 지정에 지원되는 문서 형식
사용자 지정 프로젝트를 만들 때 프로젝트에서 사용할 문서 형식을 선택할 수 있습니다. 자세한 내용은 방법: Visual Studio에서 Office 프로젝트 만들기를 참조하세요.
다음 표에서는 Excel 및 Word의 문서 수준 사용자 지정에서 사용할 수 있는 문서 형식을 보여 줍니다.
| Excel | Word |
|---|---|
| Excel 통합 문서(.xlsx) Excel 매크로 사용 통합 문서(.xlsm) Excel 이진 통합 문서(.xlsb) Excel 97-2003 통합 문서(.xls) Excel 서식 파일(.xlt) Excel 매크로 사용 서식 파일(.xltm) Excel 97-2003 서식 파일(.xlt) |
Word 문서(.docx) Word 매크로 사용 문서(.docm) Word 97-2003 문서(.doc) Word 서식 파일(.dotx) Word 매크로 사용 서식 파일(.dotm) Word 97-2003 서식 파일(.dot) |
지원되는 형식의 문서에 대해서만 관리 코드 확장을 디자인해야 합니다. 그렇지 않으면 애플리케이션에서 문서가 열릴 때 특정 이벤트가 발생하지 않을 수 있습니다. 예를 들어 Excel XML 스프레드시트 형식이나 웹 페이지(.htm, .html) 형식으로 저장된 통합 문서에서 관리 코드 확장을 사용하면 Open 이벤트가 발생하지 않습니다.
파일 이름 확장명이 .xml인 Word 문서 지원
문서 수준 프로젝트 템플릿에서는 다음과 같은 파일 형식을 기반으로 프로젝트를 만드는 것을 허용하지 않습니다.
Word XML 문서(*xml)
Word 2003 XML 문서(*xml)
최종 사용자가 이러한 파일 형식으로 사용자 지정을 사용하도록 하려면 위의 표에 지정된 지원되는 파일 형식 중 하나를 사용하는 사용자 지정을 빌드하고 배포합니다. 사용자 지정을 설치한 후 최종 사용자는 문서를 Word XML 문서(*xml) 형식이나 Word 2003 XML 문서(*xml) 형식으로 저장할 수 있으며 사용자 지정은 예상대로 계속 작동합니다.
사용자 지정 구성 요소
사용자 지정의 주요 구성 요소는 문서와 어셈블리입니다. 이러한 구성 요소 외에 Microsoft Office 애플리케이션이 사용자 지정을 검색하고 로드하는 방식에서 중요한 역할을 하는 몇 가지 다른 부분이 있습니다.
배포 매니페스트 및 애플리케이션 매니페스트
사용자 지정은 배포 매니페스트와 애플리케이션 매니페스트를 사용하여 최신 버전의 사용자 지정 어셈블리를 식별하고 로드합니다. 배포 매니페스트는 현재 애플리케이션 매니페스트를 가리킵니다. 애플리케이션 매니페스트는 사용자 지정 어셈블리를 가리키고 어셈블리에서 실행할 진입점 클래스를 지정합니다. 자세한 내용은 Office 솔루션의 애플리케이션 및 배포 매니페스트를 참조하세요.
Visual Studio Tools for Office Runtime
Visual Studio에서 Office 개발자 도구를 사용하여 만든 문서 수준 사용자 지정을 실행하려면 최종 사용자 컴퓨터에 Visual Studio Tools for Office가 설치되어 있어야 합니다. Visual Studio Tools for Office에는 사용자 지정 어셈블리를 로드하는 관리되지 않는 구성 요소뿐만 아니라 관리되는 어셈블리 세트도 포함됩니다. 관리되는 어셈블리는 사용자 지정 코드에서 호스트 애플리케이션을 자동화하고 확장하는 데 사용하는 개체 모델을 제공합니다.
자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하세요.
사용자 지정이 Microsoft Office 애플리케이션과 작동하는 방식
사용자가 Microsoft Office 사용자 지정의 일부인 문서를 열 때 애플리케이션은 문서와 연결된 배포 매니페스트를 사용하여 최신 버전의 사용자 지정 어셈블리를 찾아 로드합니다. 배포 매니페스트 위치는 AssemblyLocation이라는 사용자 지정 문서 속성에 저장됩니다. 솔루션을 빌드할 때 이 위치를 식별하는 문자열이 속성에 삽입됩니다.
배포 매니페스트는 애플리케이션 매니페스트를 가리키며 그때 가장 최신 어셈블리를 가리킵니다. 자세한 내용은 Office 솔루션의 애플리케이션 및 배포 매니페스트를 참조하세요.
다음 그림에서는 문서 수준 사용자 지정의 기본 아키텍처를 보여 줍니다.
참고 항목
.NET Framework 4를 대상으로 지정하는 Office 솔루션에서 솔루션은 PIA(주 interop 어셈블리)를 직접 호출하는 대신 솔루션 어셈블리에 포함된 PIA 형식 정보를 사용하여 호스트 애플리케이션의 개체 모델을 호출합니다. 자세한 내용은 Office 솔루션 디자인 및 만들기를 참조하세요.
로드 프로세스
다음 단계는 사용자가 Microsoft Office 솔루션의 일부인 문서를 열 때 발생합니다.
Microsoft Office 애플리케이션은 사용자 지정 문서 속성에서 문서와 연결된 관리 코드 확장이 있는지 여부를 확인합니다. 자세한 내용은 사용자 지정 문서 속성 개요를 참조하세요.
관리 코드 확장이 있으면 애플리케이션에서 VSTOLoader.dll을 로드하는 VSTOEE.dll을 로드합니다. 이러한 DLL은 Visual Studio 2010 Tools for Office 런타임의 로더 구성 요소인 관리되지 않는 DLL입니다. 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하세요.
VSTOLoader.dll에서 .NET Framework를 로드하고 Visual Studio Tools for Office 런타임의 관리되는 부분을 시작합니다.
문서가 로컬 컴퓨터와 다른 위치에서 열리면 Visual Studio Tools for Office에서 문서 위치가 특정 Office 애플리케이션의 보안 센터 설정에 있는 신뢰할 수 있는 위치 목록에 있는지 확인합니다. 문서가 신뢰할 수 있는 위치에 없는 경우 사용자 지정을 신뢰할 수 없기 때문에 로드 프로세스가 여기서 중지됩니다.
Visual Studio Tools for Office 런타임은 솔루션이 아직 설치되지 않았으면 솔루션을 설치하고 최신 애플리케이션 매니페스트와 배포 매니페스트를 다운로드하여 일련의 보안 검사를 수행합니다. 자세한 내용은 Office 솔루션 보호를 참조하세요.
실행하는 데 사용자 지정을 신뢰할 수 있는 경우 Visual Studio Tools for Office 런타임은 배포 매니페스트와 애플리케이션 매니페스트를 사용하여 어셈블리 업데이트를 확인합니다. 새 버전의 어셈블리를 사용할 수 있으면 런타임에서 새 버전의 어셈블리를 클라이언트 컴퓨터의 ClickOnce 캐시에 다운로드합니다. 자세한 내용은 Office 솔루션 배포를 참조하세요.
Visual Studio Tools for Office 런타임은 사용자 지정 어셈블리를 로드할 새로운 애플리케이션 도메인을 만듭니다.
Visual Studio Tools for Office 런타임은 사용자 지정 어셈블리를 애플리케이션 도메인에 로드합니다.
Visual Studio Tools for Office 런타임은 사용자 지정 어셈블리에서 시작 이벤트 처리기를 호출합니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.
관련 콘텐츠
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기