다음을 통해 공유

Office 솔루션의 문제 해결

  • 아티클

적용 대상: Visual Studio

이 문서에서는 Visual Studio에서 Office 솔루션을 개발하는 동안 다른 작업을 수행할 때 발생할 수 있는 문제를 해결하는 방법을 소개합니다.

프로젝트를 만들고, 업그레이드하고, 열 때 발생하는 문제

Office 프로젝트를 만들거나 열 때 다음과 같은 문제가 발생할 수 있습니다.

문제 1: 프로젝트를 만들 수 없습니다.

Office 프로젝트를 만들거나 열려고 할 때 오류가 발생하지만 Visual Studio에 원인을 확인할 충분한 정보가 없는 경우 프로젝트를 닫고 Visual Studio를 종료한 다음 다시 시작해 보세요.

문서 수준 프로젝트를 만들려는 경우 새 프로젝트의 문서와 이름이 같은 다른 문서가 Excel 또는 Word에서 이미 열려 있을 수 있습니다. Excel 또는 Word의 다른 모든 인스턴스가 닫혀 있는지 확인합니다.

문제 2: 기존 프로젝트의 문서를 기반으로 새 프로젝트를 만들 때 컨트롤 속성이 손실됩니다.

기존 프로젝트의 문서를 기반으로 새 Office 프로젝트를 만드는 경우 문서에 있는 컨트롤의 속성이 새 프로젝트에 복사되지 않습니다. 기존 컨트롤의 속성을 수동으로 다시 설정합니다. 또는 새 프로젝트를 만드는 대신 기존 프로젝트의 복사본을 만들거나 디자이너에서 기존 프로젝트를 새 솔루션에 로드하고 기존 문서에서 새 문서로 컨트롤을 복사하여 붙여넣으면 컨트롤 속성을 유지할 수 있습니다.

문제 3: 기존 통합 문서를 기반으로 Excel 통합 문서 프로젝트를 만들 때 발생하는 오류

기존 통합 문서를 기반으로 하여 새 Excel 통합 문서 프로젝트를 만드는 경우 다음 오류의 조합이 표시될 수 있습니다.

  • Excel에서: "개인 정보 경고: 이 문서에는 매크로, ActiveX 컨트롤, XML 확장 팩 정보, 웹 구성 요소가 있습니다. 문서 검사에서 제거할 수 없는 개인 정보가 포함되어 있을 수 있습니다."
  • Visual Studio에서: "디자이너를 제대로 로드하지 못했습니다.

이러한 오류는 해당 개인 정보가 문서 검사를 사용하여 제거된 통합 문서를 기반으로 하는 프로젝트를 만들려는 경우에 발생할 수 있습니다. 이 문제를 방지하려면 프로젝트를 만들기 전에 다음 단계를 수행합니다.

  1. Excel에서 통합 문서를 엽니다.
  2. Excel에서 보안 센터를 엽니다.
  3. 개인 정보 옵션 탭의 저장 확인란에서 파일 속성에서 개인 정보 제거 확인란의 선택을 취소합니다.
  4. 통합 문서를 저장하고 Excel을 닫습니다.

문제 4: 마이그레이션 후 프로젝트를 열 수 없습니다.

Office 솔루션을 Microsoft Office 2010으로 마이그레이션한 후에는 2007 Microsoft Office 시스템만 설치된 개발 컴퓨터에서 프로젝트를 열 수 없습니다. 다음과 같은 오류가 표시될 수 있습니다.

  • "솔루션의 프로젝트 중 하나 이상이 제대로 로드되지 않았습니다. 자세한 내용은 출력 창을 참조하세요."
  • "이 프로젝트 형식과 연결된 애플리케이션이 이 컴퓨터에 설치되어 있지 않아 프로젝트를 만들 수 없습니다. 이 프로젝트 형식과 연결된 Microsoft Office 애플리케이션을 설치해야 합니다."

이 문제를 해결하려면 .vbproj 또는 .csproj 파일을 편집합니다. Word 프로젝트의 HostPackage="{763FDC83-64E5-4651-AC9B-28C4FEB985A1}" HostPackage="{6CE98B71-D55A-4305-87A8-0D6E368D9600}"경우 . Excel 프로젝트의 HostPackage="{B284B16A-C42C-4438-BDCD-B72F4AC43CFB}" HostPackage="{825100CF-0BA7-47EA-A084-DCF3308DAF74}"경우 . Outlook 프로젝트의 HostPackage="{D2B20FF5-A6E5-47E1-90E8-463C6860CB05}" HostPackage="{20A848B8-E01F-4801-962E-25DB0FF57389}"경우 .

또는 Microsoft Office 2010이 이미 설치된 개발 컴퓨터에서만 마이그레이션된 프로젝트를 열어야 합니다.

문제 5: Windows Forms 컨트롤이 포함된 업그레이드된 Office 2003 문서 수준 프로젝트의 오류

Microsoft Office 2003 문서 수준 프로젝트를 업그레이드하는 경우 문서에 Windows Forms 컨트롤이 포함되어 있으면 업그레이드된 프로젝트에서 컴파일 시간 또는 런타임 오류가 발생할 수 있습니다. 이 문제를 방지하려면 프로젝트를 업그레이드하기 전에 개발 컴퓨터에 Visual Studio 2005 Tools for Office Second Edition Runtime을 설치합니다. 이 런타임 버전은 Microsoft 다운로드 센터의 Microsoft Visual Studio 2005 Tools for Office Second Edition Runtime(VSTO 2005 SE)(x86)에서 재배포 가능 패키지로 다운로드할 수 있습니다.

프로젝트 업그레이드를 완료한 후 다른 Office 솔루션에서 사용하지 않는 경우 개발 컴퓨터에서 Visual Studio 2005 Tools for Office Second Edition 런타임을 제거할 수 있습니다.

디자이너를 사용할 때 발생하는 문제

문서 수준 프로젝트에서 문서, 통합 문서 또는 워크시트 디자이너로 작업할 때 다음과 같은 문제가 발생할 수 있습니다.

문제 1: 디자이너를 올바르게 로드하지 못했습니다.

다음과 같은 경우 Visual Studio에서 디자이너를 열 수 없습니다.

  • Excel 또는 Word가 이미 열려 있고 모달 대화 상자를 표시합니다. 디자이너를 열려면 Excel 또는 Word에서 모달 대화 상자가 열려 있는지 확인하고 열려 있는 모달 대화 상자를 모두 닫습니다. 열려 있는 모달 대화 상자가 없는 경우 Excel 또는 Word에서 응답하기 전에 다른 작업이 필요할 수 있습니다.
  • 현재 프로젝트를 디버그 중입니다. 디자이너를 열려면 디버깅을 중지하거나 완료합니다.
  • Excel을 시작할 때 개발 컴퓨터에 설치된 Excel VSTO 추가 기능에서 대화 상자를 표시합니다. Excel 문서 수준 프로젝트를 만들려면 먼저 VSTO 추가 기능을 사용하지 않도록 설정해야 합니다.

문제 2: 컨트롤이 문서 또는 워크시트에 검은색 사각형으로 표시됨

문서 또는 워크시트에서 컨트롤을 그룹화하는 경우 Visual Studio에서 더 이상 해당 컨트롤을 인식하지 않습니다. 그룹화된 컨트롤은 속성 창에서 액세스할 수 없으며 문서 또는 워크시트에 검은색 사각형으로 표시됩니다. 해당 기능을 복원하려면 컨트롤 그룹을 해제해야 합니다.

문제 3: Word 서식 파일의 컨트롤이 Visual Studio에 표시되지 않음

Visual Studio 디자이너에서 Word 서식 파일을 열면 텍스트와 일치하지 않는 서식 파일의 컨트롤이 표시되지 않을 수 있습니다. 이는 Visual Studio가 일반 보기에서 Word 템플릿을 열기 때문입니다. 컨트롤을 보려면 보기 메뉴를 선택하고 Microsoft Office Word 보기를 가리킨 다음 인쇄 레이아웃을 선택합니다.

문제 4: Visual Studio 디자이너에서 클립 아트 삽입 명령이 아무 것도 수행하지 않음

Visual Studio 디자이너에서 Excel 또는 Word가 열려 있는 경우 리본 메뉴의 일러스트레이션 탭에서 클립 아트 단추를 클릭하면 클립 아트 작업창이 열리지 않습니다. 클립 아트를 추가하려면 Visual Studio 외부의 주 프로젝트 폴더에 있는 통합 문서 또는 문서의 복사본(\bin 폴더에 있는 복사본 아님)을 열고 클립 아트를 추가한 다음, 통합 문서 또는 문서를 저장해야 합니다.

코드를 작성할 때 발생하는 문제

Office 프로젝트에서 코드를 작성할 때 다음과 같은 문제가 발생할 수 있습니다.

문제 1: C를 사용할 때 Office 개체의 일부 이벤트에 액세스할 수 없음#

경우에 따라 Visual C# 프로젝트에서 Office PIA(주 interop 어셈블리) 형식 인스턴스의 특정 이벤트에 액세스하려고 할 때 다음과 같은 컴파일러 오류가 표시될 수 있습니다.

'Microsoft.Office.Interop.Excel._Application.NewWorkbook'과 'Microsoft.Office.Interop.Excel.AppEvents_Event.NewWorkbook' 간의 모호성

이 오류는 개체의 다른 속성 또는 메서드와 이름이 같은 이벤트에 액세스하려고 했음을 의미합니다. 이벤트에 액세스하려면 개체를 해당 이벤트 인터페이스로 캐스팅해야 합니다.

이벤트가 있는 Office PIA 형식은 모든 속성 및 메서드를 포함하는 핵심 인터페이스와 개체에 의해 노출되는 이벤트를 포함하는 이벤트 인터페이스 등 두 개의 인터페이스를 구현합니다. 이러한 이벤트 인터페이스는 이름 지정 규칙 _<objectname>Events n>이벤트<(예: 및 ApplicationEvents2_Event.)를 AppEvents_Event 사용합니다. 개체에서 찾을 것으로 예상되는 이벤트에 액세스할 수 없는 경우 개체를 해당 이벤트 인터페이스로 캐스팅합니다.

예를 들어 Application 개체에는 NewWorkbook 이벤트와 NewWorkbook 속성이 있습니다. NewWorkbook 이벤트를 처리하려면 Application을 AppEvents_Event 인터페이스로 캐스팅합니다. 다음 코드 예제에서는 Excel용 문서 수준 프로젝트에서 이 작업을 수행하는 방법을 보여 줍니다.

private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    ((Excel.AppEvents_Event)this.Application).NewWorkbook += 
        new Excel.AppEvents_NewWorkbookEventHandler(ThisWorkbook_NewWorkbook);
}

void ThisWorkbook_NewWorkbook(Excel.Workbook Wb)
{
    // Perform some work here.
}

Office PIA의 이벤트 인터페이스에 대한 자세한 내용은 Office 주 Interop 어셈블리의 클래스 및 인터페이스 개요를 참조하세요.

문제 2: .NET Framework 4 또는 .NET Framework 4.5를 대상으로 하는 프로젝트에서 Office PIA 클래스를 참조할 수 없습니다.

.NET Framework 4 또는 .NET Framework 4.5를 대상으로 하는 프로젝트에서 Office PIA에 정의된 클래스를 참조하는 코드는 기본적으로 컴파일되지 않습니다. PIA의 클래스는 명명 규칙 <개체 이름>클래스(예: 및 WorkbookClass.)를 DocumentClass 사용합니다. 예를 들어 Word VSTO 추가 기능 프로젝트의 다음 코드는 컴파일되지 않습니다.

Word.DocumentClass document = (Word.DocumentClass) Globals.ThisAddIn.Application.ActiveDocument;

이 코드를 실행하면 다음과 같은 컴파일 오류가 발생합니다.

  • Visual Basic: "해당 어셈블리가 No-PIA 모드를 사용하여 연결되어 있으면 'DocumentClass' 클래스에 대한 참조를 사용할 수 없습니다."
  • Visual C#: "Interop 형식 'Microsoft.Office.Interop.Word.DocumentClass'를 포함할 수 없습니다. 적용 가능한 인터페이스를 대신 사용하세요."

이 오류를 해결하려면 대신 해당하는 인터페이스를 참조하도록 코드를 수정합니다. 예를 들어 DocumentClass 개체를 참조하는 대신 Document 인터페이스의 인스턴스를 참조합니다.

Word.Document document = Globals.ThisAddIn.Application.ActiveDocument;

.NET Framework 4 또는 .NET Framework 4.5를 대상으로 하는 프로젝트는 기본적으로 Office PIA의 모든 interop 형식을 자동으로 포함합니다. 이 컴파일 오류는 포함된 interop 형식 기능이 클래스가 아니라 인터페이스에서만 작동하기 때문에 발생합니다. Office PIA의 인터페이스 및 클래스에 대한 자세한 내용은 Office 주 Interop 어셈블리의 클래스 및 인터페이스 개요를 참조하세요. Office 프로젝트에 포함된 interop 형식 기능에 대한 자세한 내용은 Office 솔루션 디자인 및 만들기를 참조하세요.

문제 3: Office 수업에 대한 참조가 인식되지 않음

일부 클래스 이름(예: Application)은 Microsoft.Office.Interop.Word 및 System.Windows.Forms와 같은 여러 네임스페이스에 있습니다. 이런 이유로 프로젝트 템플릿 맨 위의 Imports/using 문에는 간략한 한정 상수가 포함됩니다. 예를 들면 다음과 같습니다.

using Word = Microsoft.Office.Interop.Word;

Imports/using 문을 이렇게 사용하려면 Word 또는 Excel 한정자를 사용하여 Office 클래스에 대한 참조를 구분해야 합니다. 예를 들면 다음과 같습니다.

Word.Document doc;

예를 들어 정규화되지 않은 선언을 사용하는 경우 오류가 발생합니다.

Document doc;  // Class is ambiguous

Word 또는 Excel 네임스페이스를 가져왔고 그 안에 있는 모든 클래스에 액세스할 수 있더라도 Word 또는 Excel을 사용하여 모든 형식을 정규화하여 네임스페이스 모호성을 제거해야 합니다.

프로젝트를 빌드할 때 발생하는 문제

Office 프로젝트를 빌드할 때 다음과 같은 문제가 발생할 수 있습니다.

문제 1: 권한이 제한된 문서를 기반으로 하는 문서 수준 프로젝트를 빌드할 수 없습니다.

문서에 제한된 권한이 있는 경우 Visual Studio에서 문서 수준 프로젝트를 빌드할 수 없습니다. 프로젝트에 사용 권한이 제한된 문서가 포함되어 있으면 프로젝트가 컴파일되지 않으며 오류 목록 창에 다음 메시지가 표시됩니다.

사용자 지정을 추가하지 못했습니다.

제한된 권한을 가진 문서를 포함하려는 경우 솔루션을 개발 및 빌드하는 동안 무제한 문서를 사용합니다. 그런 다음 솔루션을 게시한 후 게시 위치의 문서에 제한된 권한을 적용합니다.

문제 2: NamedRange 컨트롤이 삭제된 후 컴파일러 오류가 발생합니다.

디자이너의 NamedRange 현재 워크시트가 아닌 워크시트에서 컨트롤을 삭제하면 자동 생성된 코드가 프로젝트에서 제거되지 않을 수 있으며 컴파일러 오류가 발생할 수 있습니다. 코드를 제거하려면 컨트롤을 삭제하기 전에 항상 NamedRange 컨트롤이 포함된 워크시트를 선택하여 활성 워크시트로 만들어야 합니다. 컨트롤을 삭제할 때 자동 생성된 코드가 삭제되지 않으면 워크시트를 활성화하고 변경하여 워크시트가 수정된 것으로 표시되도록 디자이너에서 코드를 삭제할 수 있습니다. 프로젝트를 다시 빌드하면 코드가 제거됩니다.

프로젝트를 디버그할 때 발생하는 문제

Office 프로젝트를 디버그할 때 다음과 같은 문제가 발생할 수 있습니다.

문제 1: 개발 컴퓨터에 솔루션을 게시하고 설치할 때 제거하라는 메시지가 표시됩니다.

Office 솔루션을 디버그할 때 다음과 같은 오류가 표시될 수 있습니다.

다른 버전이 현재 설치되어 있고 이 위치에서 업그레이드할 수 없으므로 사용자 지정을 설치할 수 없습니다.

이 오류는 이전에 개발 컴퓨터에 Office 솔루션을 게시하고 설치했음을 나타냅니다. 메시지를 표시하지 않으려면 솔루션을 디버그하기 전에 컴퓨터에 설치된 프로그램 목록에서 솔루션을 제거합니다. 또는 개발 컴퓨터에서 다른 사용자 계정을 만들어 게시된 솔루션의 설치를 테스트할 수 있습니다.

문제 2: UNC 네트워크 위치에서 만든 문서 수준 프로젝트가 Visual Studio에서 실행되지 않음

UNC 네트워크 위치에 Excel 또는 Word용 문서 수준 프로젝트를 만드는 경우 Excel 또는 Word의 신뢰할 수 있는 위치 목록에 문서 위치를 추가해야 합니다. 그렇지 않으면 Visual Studio에서 프로젝트를 실행하거나 디버그하려고 할 때 사용자 지정이 로드되지 않습니다. 신뢰할 수 있는 위치에 대한 자세한 내용은 문서에 신뢰 부여를 참조하세요.

문제 3: 디버깅 후 스레드가 올바르게 중지되지 않음

Visual Studio의 Office 프로젝트는 디버거가 프로그램을 제대로 닫을 수 있도록 하는 스레드 명명 규칙을 따릅니다. 솔루션에서 스레드를 만드는 경우 각 스레드의 이름에 접두사 VSTA_를 지정하여 디버깅을 중지할 때 이러한 스레드가 올바르게 처리되도록 해야 합니다. 예를 들어 VSTA_NetworkListener에 대한 네트워크 이벤트를 기다리는 스레드의 Name 속성을 설정할 수 있습니다.

문제 4: 개발 컴퓨터에서 Office 솔루션을 실행하거나 디버그할 수 없습니다.

개발 컴퓨터에서 Office 프로젝트를 실행하거나 개발할 수 없는 경우 다음 오류 메시지가 표시 될 수 있습니다.

애플리케이션 도메인을 만들 수 없으므로 사용자 지정을 로드할 수 없습니다.

Visual Studio는 Office 솔루션을 로드하기 전에 .NET Framework 어셈블리 로더인 Fusion을 사용하여 어셈블리를 캐시합니다. Visual Studio가 Fusion 캐시에 쓸 수 있는지 확인한 후 다시 시도합니다. 자세한 내용은 어셈블리 섀도 복사를 참조하세요.

문제 5: 편집 및 계속을 사용한 후 문서 수준 프로젝트에서 디버거를 중지할 때 오류 발생

편집하며 계속을 사용하여 프로젝트가 중단 모드에 있는 동안 Excel 또는 Word용 문서 수준 프로젝트에서 코드를 변경하는 경우 디버거를 중지하면 다음 오류 메시지가 포함된 대화 상자가 표시될 수 있습니다.

프로세스를 현재 상태로 종료하면 데이터 손실 및 시스템 불안정을 포함하여 원치 않는 결과가 발생할 수 있습니다.

대화 상자에서 예 또는 아니요를 선택하든 관계없이 Visual Studio는 Excel 또는 Word 프로세스를 종료하고 디버거를 중지합니다. 이 대화 상자를 표시하지 않고 프로젝트 디버깅을 중지하려면 Visual Studio에서 디버거를 중지하는 대신 Excel 또는 Word를 직접 종료합니다.

참조