Office 프로젝트 디버그
다른 Visual Studio 프로젝트에 사용하는 것과 동일한 Microsoft Visual Studio 도구를 사용하여 Office 프로젝트를 디버그할 수 있습니다. 중단점 삽입 및 로컬 창에 변수 표시와 같은 Visual Studio 디버거 기능은 Office 프로젝트를 디버그할 때도 사용할 수 있습니다. Visual Studio 디버깅 도구에 대한 자세한 내용은 Visual Studio의 디버깅을 참조하세요.
팁
디버깅을 간소화하려면 빌드하고 디버그하기 전에 Office 애플리케이션의 열린 인스턴스를 모두 닫습니다.
적용 대상: 이 항목의 정보는 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.
참고 항목
여러 플랫폼에서 Office 환경을 확장하는 솔루션을 개발하는 데 관심이 있으신가요? 새로운 Office 추가 기능 모델을 확인하세요. Office 추가 기능은 VSTO 추가 기능과 솔루션에 비해 공간을 적게 사용하며 HTML5, JavaScript, CSS3 및 XML과 같은 거의 모든 웹 프로그래밍 기술을 사용하여 빌드할 수 있습니다.
디버거 시작 및 중지
다른 Visual Studio 프로젝트 디버깅을 시작하는 것처럼 Office 프로젝트 디버깅을 시작할 수 있습니다. 예를 들어 F5 키를 누르면 됩니다. VSTO 추가 기능 프로젝트 디버깅을 시작하면 대상 Office 애플리케이션에 대한 새 프로세스가 시작되고 VSTO 추가 기능이 로드됩니다.
문서 수준 프로젝트의 디버깅을 시작하면 문서 또는 통합 문서가 새로운 Word 또는 Excel 프로세스로 열립니다.
디버거를 중지하면 디버거에서 애플리케이션 프로세스를 갑자기 종료하거나 디버거를 분리로 설정한 경우에는 분리합니다. 종료된 Office 애플리케이션 프로세스에서 연 다른 모든 문서도 경고를 표시하지 않고 닫혀 저장되지 않은 모든 변경 내용이 손실됩니다. 여기에는 디버거가 실행되는 동안 열린 모든 문서 또는 통합 문서가 포함될 수 있습니다.
일반적으로 디버거를 중지하기 전에 프로세스에서 분리하여 정상적인 방식으로 Office 애플리케이션을 종료할 수 있도록 하는 것이 좋습니다. 또한 디버거를 중지한 후에도 열려 있는 문서 또는 워크시트로 계속 작업하려는 경우 프로세스에서 분리할 수 있습니다.
Word에 대해 문서 수준 사용자 지정을 디버깅하는 경우 반복적으로 디버거를 중지하여 Word가 갑자기 닫히도록 하면 기본 서식 파일이 손상될 수 있습니다. 이런 경우 손상된 기본 서식 파일을 삭제할 수 있습니다. 그러면 다음에 Word를 열 때 자동으로 다시 만들어집니다. 그러나 기본 서식 파일에 저장된 모든 매크로는 다시 만들어지지 않습니다.
Office 2013 또는 Office 2016을 사용하여 Office 2013 VSTO 추가 기능 디버깅
Visual Studio 2015를 사용하는 경우 Office의 두 버전을 모두 병렬로 설치하면 Visual Studio에서 Office 2016을 시작합니다. Visual Studio 2013을 사용하는 경우에는 Visual Studio가 Office 2013을 시작합니다.
다른 버전의 Office(2013 또는 2016)를 사용하여 VSTO 추가 기능을 디버그하려면 프로젝트 디자이너를 열고 디버그 탭에서 시작 외부 프로그램 옵션 단추를 선택합니다. 그런 다음 적절한 Office 애플리케이션 실행의 위치로 이동합니다.
F10 및 F11 동작
Office 프로젝트 디버깅을 시작하면 다른 Visual Basic 또는 C# 프로젝트 디버깅을 시작할 때 F10 및 F11 동작이 다릅니다. Visual Basic 또는 C# 프로젝트에서는 디버거가 main 함수에서 중지하고 Office 프로젝트에서는 Visual Studio가 Office 애플리케이션의 main 함수를 제어하지 않습니다. 그러나 디버깅 중에는 F10과 F11이 Visual Basic 및 C# 프로젝트에서처럼 동일한 역할을 수행합니다.
예외 표시
관리 코드가 비관리 코드와 상호 작용하는 방식으로 인해 Visual Studio는 Microsoft Office 애플리케이션에서 throw되는 오류를 표시하지 않습니다. 예를 들어 Visual Studio에서 Office 개발 도구를 사용하여 만든 VSTO 추가 기능에서 예외를 throw하는 경우 Microsoft Office 애플리케이션은 오류를 표시하지 않고 계속 진행됩니다. 이러한 오류를 표시하려면 공용 언어 런타임 예외에서 중단하도록 디버거를 설정합니다. 자세한 내용은 디버거를 사용한 예외 관리를 참조하세요.
공용 언어 런타임 예외에서 중단하도록 디버거를 설정하면 이미 처리한 예외 및 런타임 자체의 몇 가지 첫째 예외를 포함한 모든 예외가 프로젝트와 관련 없는 디버거로 중단됩니다. 찾을 수 없는 msosec를 참조하는 오류가 모든 프로젝트에 나타나지만 무시해도 됩니다. 이러한 msosec 예외는 솔루션에 영향을 주지 않습니다.
메서드에서 Try...Catch 문을 사용하여 예외를 catch할 수도 있습니다.
기본적으로 Visual Studio는 Office 프로젝트에 대한 Just-In-Time 디버깅 오류를 표시하지 않습니다. 그러나 이 기능을 사용하도록 설정하여 발생되는 오류를 표시할 수 있습니다. 자세한 내용은 Visual Studio의 Just-In-Time 디버깅을 참조하세요.
명령줄 인수
디버그 속성 페이지에서 시작 작업을 시작 프로젝트로 설정하면 Visual Studio는 명령줄 인수를 시작 옵션으로 지정한 경우에도 프로젝트를 디버그할 때 명령줄 인수를 사용하지 않습니다. 디버깅을 시작할 때 명령줄 인수를 사용하려면 시작 프로젝트가 아니라 시작 작업을 선택해야 합니다.
소스 컨트롤
디버그 속성은 소스 제어에서 여러 사용자 간에 공유되지 않습니다. Visual Basic 및 C# 프로젝트는 디버깅 속성을 사용자별 파일(ProjectName.vbproj.user 또는 ProjectName.csproj.user)에 저장하며 이 파일은 소스 제어에서 사용되지 않습니다. 둘 이상의 사용자를 디버깅하는 경우 각 사용자가 디버그 속성을 수동으로 입력해야 합니다.
문서 수준 프로젝트에서 캐시된 데이터 세트 디버깅
프로젝트를 빌드할 때마다 데이터 세트가 비워지고 다시 만들어집니다. 캐시된 데이터 세트를 디버그하려면 Visual Studio 외부에서 문서를 열고 디버거를 연결해야 합니다.
Word 97~2003 문서(*.doc) 형식을 기반으로 한 Word 문서 프로젝트 디버깅
Word 97~2003 문서(/.doc*) 형식을 기반으로 한 Word 문서 프로젝트를 디버그하려면 신뢰할 수 있는 폴더 목록에 프로젝트 폴더를 추가해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 문서에 신뢰 부여를 참조하세요.
비활성화된 추가 기능 디버깅
Microsoft Office 애플리케이션에서는 예기치 않게 동작하는 VSTO 추가 기능을 사용하지 않도록 설정할 수 있습니다. Microsoft Office 애플리케이션에서는 애플리케이션이 시작될 때마다 문제가 있는 코드가 로드되지 않도록 하는 VSTO 추가 기능을 사용하지 않도록 설정합니다. 그러나 일반적인 디버깅 중에는 예기치 않은 동작이 쉽게 발생할 수 있습니다. VSTO 추가 기능을 다시 사용하도록 설정하는 방법에 대한 자세한 내용은 방법: 비활성화된 VSTO 추가 기능 다시 활성화를 참조하세요.
Microsoft Office 애플리케이션에서 VSTO 추가 기능에 사용할 수 있는 비활성화는 하드 비활성화와 소프트 비활성화의 두 가지 유형이 있습니다.
하드 비활성화
하드 비활성화는 VSTO 추가 기능으로 인해 애플리케이션이 예기치 않게 닫히는 경우에 발생할 수 있습니다. 또한 개발 컴퓨터에서 VSTO 추가 기능의 Startup 이벤트 처리기가 실행되고 있는 동안 디버거를 중지하는 경우 발생합니다. VSTO 추가 기능이 하드 비활성화되면 애플리케이션의 사용할 수 없는 항목 목록에 나타납니다.
Visual Studio에서 Office 개발 도구를 사용하여 만든 VSTO 추가 기능을 Office 애플리케이션에서 하드 비활성화하면 애플리케이션은 오류를 발생시킨 VSTO 추가 기능만 비활성화합니다. 해당 Office 애플리케이션에 대해 Visual Studio에서 Office 개발 도구를 사용하여 만든 다른 VSTO 추가 기능은 계속 로드됩니다.
소프트 비활성화
소프트 비활성화는 VSTO 추가 기능에서 애플리케이션이 예기치 않게 닫히지 않는 오류를 생성하는 경우 수행됩니다. 예를 들어 Startup 이벤트 처리기가 실행되는 동안 처리되지 않은 예외가 발생하는 경우 애플리케이션에서 VSTO 추가 기능을 소프트 비활성화할 수 있습니다. VSTO 추가 기능이 소프트 비활성화되면 애플리케이션의 비활성 애플리케이션 추가 기능 목록에 나타나고 애플리케이션은 VSTO 추가 기능에 대한 LoadBehavior 레지스트리 항목의 값을 변경하여 언로드됨을 나타냅니다. LoadBehavior 레지스트리 항목에 대한 자세한 내용은 VSTO 추가 기능에 대한 레지스트리 항목을 참조하세요.
이벤트 뷰어를 사용하여 설치 오류 문제 해결
Visual Studio Tools for Office Runtime은 Office 솔루션을 설치하거나 제거할 때 throw되는 모든 예외에 대한 메시지를 Windows의 이벤트 뷰어에 기록합니다. 이러한 메시지를 사용하여 설치 및 배포 문제를 해결할 수 있습니다.
로그 파일 및 오류 메시지를 사용하여 시작 오류 문제 해결
Visual Studio Tools for Office Runtime은 시작하는 동안 발생하는 모든 오류를 로그 파일에 기록하거나 각 오류를 메시지 상자에 표시할 수 있습니다. 기본적으로 이러한 옵션은 해제되어 있습니다. 환경 변수를 만들어 옵션을 설정할 수 있습니다.
메시지 상자에 각 오류를 표시하려면 VSTO_SUPPRESSDISPLAYALERTS 라는 환경 변수를 만들어 0으로 설정합니다. 환경 변수를 삭제하거나 1로 설정하여 메시지를 표시하지 않을 수 있습니다.
오류를 로그 파일에 기록하려면 VSTO_LOGALERTS 라는 환경 변수를 만들고 1로 설정합니다. Visual Studio Tools for Office Runtime은 VSTO 추가 기능에 대한 배포 매니페스트를 포함하는 폴더 또는 사용자 지정과 관련된 문서 또는 통합 문서를 포함하는 폴더에 로그 파일을 만듭니다. 이것이 실패하면 Visual Studio Tools for Office Runtime은 로컬 %TEMP% 폴더에 로그 파일을 만듭니다. 애플리케이션 수준 VSTO 추가 기능의 경우 기본 이름은 추가 기능 이름.vsto.log입니다. 문서 수준 프로젝트의 경우 로그 파일의 이름은 문서 이름.확장명.log(예: ExcelWorkbook1.xlsx.log)입니다. 오류 로깅을 중지하려면 환경 변수를 삭제하거나 0으로 설정합니다.