응용 프로그램 수준 추가 기능에 대한 레지스트리 항목
업데이트: 2010년 5월
Visual Studio 2010를 사용하여 만든 추가 기능을 배포할 때 특정 레지스트리 항목 집합을 만들어야 합니다. 이러한 레지스트리 항목은 Microsoft Office 응용 프로그램에서 추가 기능을 검색하고 로드할 수 있게 해 주는 정보를 제공합니다.
적용 대상: 이 항목의 정보는 Microsoft Office 2010 및 2007 Microsoft Office system의 응용 프로그램 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.
프로젝트를 빌드하면 추가 기능을 쉽게 실행하고 디버깅할 수 있도록 Visual Studio에서 배포 컴퓨터에 이러한 레지스트리 항목을 만듭니다. Clickonce를 사용하여 추가 기능을 배포하는 경우 레지스트리 항목이 최종 사용자 컴파일러에 자동으로 생성됩니다. Windows Installer를 사용하여 추가 기능을 배포하면 설치 프로젝트를 구성하여 최종 사용자 컴퓨터에 레지스트리 항목을 만들어야 합니다.
추가 기능 로드 프로세스 동안 레지스트리 항목이 사용되는 방식에 대한 자세한 내용은 응용 프로그램 수준 추가 기능 아키텍처를 참조하십시오.
참고
이 항목에서 add-in ID 텍스트는 추가 기능의 고유 ID를 나타냅니다. 기본적으로 이 ID는 추가 기능 어셈블리의 이름입니다.
현재 사용자와 다음에 대한 추가 기능을 등록합니다.모든 사용자
추가 기능이 설치되면 다음 두 가지 방법으로 등록할 수 있습니다:
현재 사용자 전용입니다(즉, 추가 기능을 설치했을 때 컴퓨터에 로그온하는 사용자만 사용할 수 있습니다). 이 경우 HKEY_CURRENT_USER 아래에 레지스트리 항목이 생성됩니다.
모든 사용자용입니다. 즉, 컴퓨터에 로그온하는 모든 사용자가 추가 기능을 사용할 수 있습니다. 이 경우 HKEY_LOCAL_MACHINE 아래에 레지스트리 항목이 생성됩니다.
현재 사용자가 등록할 수 있는 Visual Studio 2010을(를) 사용하여 만들어진 모든 추가 기능입니다. 그러나, 특정 시나리오에만 모든 사용자에 대해 추가 기능을 등록할 수 있습니다. 이러한 시나리오는 컴퓨터의 Microsoft Office 버전과 추가 기능이 배포된 방식에 따라 다릅니다.
Microsoft Office 버전
Microsoft Office 2010 응용 프로그램은 HKEY_LOCAL_MACHINE 또는 HKEY_CURRENT_USER에 등록된 추가 기능을 로드할 수 있습니다.
기본적으로 2007 Microsoft Office system의 응용 프로그램에서는 HKEY_CURRENT_USER 아래에 등록된 추가 기능만 로드할 수 있습니다. HKEY_LOCAL_MACHINE에 등록되어 있는 추가 기능을 로드하려면 이 응용 프로그램이 설치된 컴퓨터에 핫픽스 패키지 976477도 설치되어 있어야 합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?LinkId=184923 페이지를 참조하십시오.
배포 형식
ClickOnce를 사용하여 추가 기능을 배포하는 경우 추가 기능은 현재 사용자에 대해서만 등록될 수 있습니다. 이유는 ClickOnce가 HKEY_CURRENT_USER 아래에서의 키 생성만 지원하기 때문입니다. 컴퓨터의 모든 사용자가 추가 기능을 등록하도록 하려면 Windows Installer를 사용하여 추가 기능을 배포해야 합니다. 이러한 배포 형식에 대한 자세한 내용은 Office 솔루션 게시 및 Windows Installer를 사용하여 Office 솔루션 배포를 참조하십시오.
레지스트리 항목
필수 추가 기능 레지스트리는 Visio를 제외한 모든 응용 프로그램에 대한 레지스트리 키 아래에 위치해 있습니다. 즉, 루트가 HKEY_CURRENT_USER 또는 HKEY_LOCAL_MACHINE인 위치입니다.
Root\Software\Microsoft\Office\application name\Addins\add-in ID
Visio의 경우 레지스트리 항목은 다음 레지스트리 키 아래에 있습니다.
루트\Software\Microsoft\Visio\Addins\add-in ID
다음 표에서는 이 레지스트리 키 아래에 항목을 나열합니다.
Entry |
형식 |
값 |
|---|---|---|
Description |
REG_SZ |
필수적 요소로서, 추가 기능의 간단한 설명 이 설명은 사용자가 Microsoft Office 응용 프로그램의 옵션 대화 상자에 있는 추가 기능 창에서 추가 기능을 선택할 때 표시됩니다. |
FriendlyName |
REG_SZ |
필수적 요소로서, Microsoft Office 응용 프로그램의 COM 추가 기능 대화 상자에 표시되는 추가 기능의 서술적 이름이며, 기본값은 추가 기능 ID입니다. |
LoadBehavior |
REG_DWORD |
필수적 요소로서, 응용 프로그램에서 추가 기능을 로드할 시기와 추가 기능의 현재 상태(로드됨 또는 언로드됨)를 지정하는 값입니다. 기본적으로 이 항목은 시작 시 추가 기능이 로드되도록 지정하는 3으로 설정되어 있습니다. 자세한 내용은 LoadBehavior 값을 참조하십시오. |
Manifest |
REG_SZ |
필수적 요소로서, 추가 기능에 대한 배포 매니페스트의 전체 경로입니다. 이 경로는 로컬 컴퓨터, 네트워크 공유(UNC) 또는 웹 서버(HTTP)의 위치일 수 있습니다. Windows Installer를 사용하여 솔루션을 배포하는 경우 문자열 |vstolocal(즉, 파이프 문자)을 추가합니다. |이 경로 다음에 vstolocal이 나옵니다. 이렇게 하면 솔루션이 ClickOnce 캐시에서 로드되지 않고 설치 폴더에서 로드됩니다. 자세한 내용은 Windows Installer를 사용하여 Office 솔루션 배포을 참조하십시오. .gif "참고") 참고
개발 컴퓨터에 추가 기능을 빌드하면 Visual Studio에서는 |vstolocal 문자열을 이 레지스트리 항목에 자동으로 추가합니다.
|
Warmup |
REG_DWORD |
선택적 요소로서, 추가 기능을 로드하기 전에 .NET Framework 및 Microsoft Visual Studio Tools for Office Runtime을 로드하고 추가 기능을 로드하는 데 걸리는 시간을 줄임을 나타내는 값입니다. Warmup 항목을 1로 설정하여 LoadBehavior 항목과 함께 사용하고 Windows Installer(.msi)를 사용하여 배포되는 Outlook 2010 추가 기능의 로드 시간을 줄입니다. 이 레지스트리 키는 ClickOnce를 사용하여 설정할 수 없습니다. |
Outlook 양식 영역에 대한 레지스트리 항목
Outlook용 추가 기능에서 사용자 지정 양식 영역을 만들 경우 추가 레지스트리 항목을 사용하여 양식 영역을 Outlook에 등록합니다. 이러한 항목은 양식 영역이 지원하는 각 메시지에 대해 다른 레지스트리 키 아래 만들어집니다. 이러한 레지스트리 키는 다음 위치에 있으며, 여기서 루트는 HKEY_CURRENT_USER 또는 HKEY_LOCAL_MACHINE입니다.
Root\Software\Microsoft\Office\Outlook\FormRegions\message class
모든 추가 기능에서 공유하는 다른 레지스트리 항목과 마찬가지로 Visual Studio는 프로젝트를 빌드할 때 개발 컴퓨터에 폼 영역 레지스트리 항목을 만듭니다. Clickonce를 사용하여 추가 기능을 배포하는 경우 레지스트리 항목이 최종 사용자 컴파일러에 자동으로 생성됩니다. Windows Installer를 사용하여 추가 기능을 배포하면 설치 프로젝트를 구성하여 최종 사용자 컴퓨터에 레지스트리 항목을 만들어야 합니다.
양식 영역 레지스트리 항목에 대한 자세한 내용은 Specifying Form Regions in the Windows Registry를 참조하십시오. Outlook 양식 영역에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하십시오.
LoadBehavior 값
Root\Software\Microsoft\Office\application name\Addins\add-in ID 키 아래의 LoadBehavior 항목은 추가 기능의 런타임 동작을 지정하는 값의 비트 조합을 포함합니다. 가장 낮은 순서 비트(값 0, 1)는 추가 기능이 현재 언로드 또는 로드되었는지 여부를 나타냅니다. 다른 비트는 응용 프로그램이 추가 기능을 로드할 때 나타냅니다.
일반적으로 LoadBehavior 엔트리는 추가 기능이 최종 사용자 컴퓨터에 설치될 때 0, 3 또는 16(10진수)으로 설정됩니다. 기본적으로 Visual Studio는 빌드하거나 게시할 때 추가 기능의 LoadBehavior 항목을 3으로 설정합니다.
다음 표에서는 LoadBehavior 항목의 가능한 모든 값을 보여 줍니다. 이 표의 일부 설명은 추가 기능을 수동으로 또는 프로그래밍 방식으로 로드하는 방법에 대한 것입니다. 추가 기능을 수동으로 로드하려면 응용 프로그램에서 COM 추가 기능 대화 상자에서 추가 기능 옆의 확인란을 선택합니다. 추가 기능을 프로그램 방식으로 로드하려면 true에 대한 추가 기능을 나타내는 COMAddIn 개체의 Connect 속성을 설정합니다.
값(10진) |
추가 기능 상태 |
추가 기능 로드 동작 |
설명 |
|---|---|---|---|
0 |
Unloaded |
자동으로 로드되지 않음 |
응용 프로그램은 추가 기능을 자동으로 로드하지 않습니다. 사용자가 수동으로 추가 기능을 로드하거나 추가 기능을 프로그래밍 방식으로 로드할 수 있습니다. 추가 기능이 성공적으로 로드된 경우 LoadBehavior 값은 0으로 남아 있지만 COM 추가 기능 대화 상자에서 추가 기능의 상태는 추가 기능이 로드되었는지 나타내도록 업데이트됩니다. |
1 |
Loaded |
자동으로 로드되지 않음 |
응용 프로그램은 추가 기능을 자동으로 로드하지 않습니다. 사용자가 수동으로 추가 기능을 로드하거나 추가 기능을 프로그래밍 방식으로 로드할 수 있습니다. COM 추가 기능 대화 상자가 응용 프로그램이 시작된 후 추가 기능이 로드되는 것을 나타내지만 수동으로 또는 프로그래밍 방식으로 로드될 때까지 실제로 로드되지 않습니다. 응용 프로그램이 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 0으로 변경되고 응용 프로그램을 닫은 후에는 0으로 유지됩니다. |
2 |
Unloaded |
시작 시 로드 |
응용 프로그램은 추가 기능을 자동으로 로드하지 않습니다. 사용자가 수동으로 추가 기능을 로드하거나 추가 기능을 프로그래밍 방식으로 로드할 수 있습니다. 응용 프로그램이 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 3으로 변경되고 응용 프로그램을 닫은 후에는 3으로 유지됩니다. |
3 |
Loaded |
시작 시 로드 |
응용 프로그램이 시작될 때 추가 기능이 로드됩니다. Visual Studio에서 추가 기능을 빌드하거나 게시할 때의 기본값입니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 3으로 유지됩니다. 추가 기능을 로드할 때 오류가 발생하면 LoadBehavior 값이 2로 유지되고 응용 프로그램을 닫은 후에는 2로 유지됩니다. |
8 |
Unloaded |
요청 시 로드 |
응용 프로그램은 추가 기능을 자동으로 로드하지 않습니다. 사용자가 수동으로 추가 기능을 로드하거나 추가 기능을 프로그래밍 방식으로 로드할 수 있습니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 9로 변경됩니다. |
9 |
Loaded |
요청 시 로드 |
추가 기능은 사용자가 추가 기능에 포함된 기능을 사용하는 UI 요소를 클릭할 때와 같이 응용 프로그램에서 추가 기능이 필요한 경우에만 로드됩니다(예를 들어, 리본의 사용자 지정 단추). 응용 프로그램이 추가 기능을 성공적으로 로드한 경우 LoadBehavior 값은 9로 남아 있지만 COM 추가 기능 대화 상자에서 추가 기능의 상태는 현재 추가 기능이 로드되었는지 나타내도록 업데이트됩니다. 추가 기능을 로드할 때 오류가 발생하는 경우 LoadBehavior 값을 8로 변경합니다. |
16 |
Loaded |
먼저 로드한 다음 요청 시 로드 |
필요할 때 추가 기능을 로드하려면 이 값을 설정합니다. 사용자가 응용 프로그램을 처음으로 실행할 때 추가 기능이 로드됩니다. 다음에 사용자가 응용 프로그램을 실행할 때는 추가 기능에 정의된 UI 요소는 모두 로드되지만 사용자가 추가 기능과 연결된 UI 요소를 클릭할 때까지 추가 기능은 로드되지 않습니다. 응용 프로그램이 처음으로 추가 기능을 성공적으로 로드하면 추가 기능이 로드되는 동안 LoadBehavior 값은 16으로 유지됩니다. 응용 프로그램을 닫은 후 LoadBehavior 값이 9로 변경됩니다. |
참고 항목
개념
기타 리소스
Visual Studio의 Office 솔루션 아키텍처
변경 기록
날짜 |
변경 내용 |
이유 |
|---|---|---|
|
2010년 5월 |
매니페스트 항목에서 |vstolocal의 사용에 대한 자세한 컨텍스트가 제공되었습니다. |
향상된 기능 관련 정보 |