Office 솔루션 업그레이드 및 마이그레이션

아티클
04/28/2010

업데이트: 2007년 11월

Visual Studio 변환 마법사를 사용하여 Visual Studio Tools for Office, Version 2003 및 Microsoft Visual Studio 2005 Tools for the Microsoft Office System의 프로젝트를 Visual Studio Tools for the Office System 3.0으로 업그레이드할 수 있습니다. Microsoft Office 솔루션을 업그레이드하려면 Visual Studio Tools for the Office System 3.0이 설치된 Visual Studio에서 솔루션을 엽니다. 그러면 Visual Studio 변환 마법사가 나타나서 업그레이드를 수행하는 데 필요한 단계를 안내해 줍니다. 자세한 내용은 방법: Visual Studio Tools for Office에서 솔루션 업그레이드를 참조하십시오.

마법사에서는 코드를 수정하지는 않습니다. 따라서 Outlook 2003 추가 기능 프로젝트를 업그레이드할 경우 코드를 수동으로 업데이트해야 합니다. 자세한 내용은 Outlook 프로젝트를 참조하십시오.

어셈블리 참조

Visual Studio 변환 마법사에서는 프로젝트 파일뿐 아니라 솔루션에 대한 기본 Microsoft Office 응용 프로그램의 주 interop 어셈블리 참조를 업그레이드합니다. 또한 새 버전 또는 업데이트된 버전의 종속 어셈블리에 대한 참조를 추가합니다. 그러나 원래 프로젝트를 만든 후 프로젝트에 수동으로 추가한 새 버전 또는 업데이트된 버전의 어셈블리에 대한 참조는 추가하지 않습니다.

예를 들어 도우미 메서드 어셈블리와 PowerPoint 주 interop 어셈블리를 참조하는 Word 2003 추가 기능 프로젝트를 업그레이드할 경우 Visual Studio 변환 마법사에서는 Word 주 interop 어셈블리와 도우미 어셈블리에 대한 참조가 올바르도록 합니다. 그러나 PowerPoint 주 interop 어셈블리에 대한 참조는 수동으로 업데이트해야 합니다.

버전 업그레이드

2007 Microsoft Office system이 설치되어 있으면 이 마법사에서는 기본적으로 Microsoft Office 2003 프로젝트를 업그레이드하여 2007 Microsoft Office system용 프로젝트가 되도록 합니다. 그러나 문서 수준 사용자 지정에 대한 절차와 응용 프로그램 수준 추가 기능에 대한 절차는 서로 다릅니다.

문서 수준 사용자 지정 프로젝트

문서 수준 사용자 지정을 업그레이드할 경우 마법사에서 프로젝트 버전을 업그레이드하지 못하게 할 수 없습니다. 문서 수준 사용자 지정을 열 때 나타나는 디자이너에서는 현재 설치된 Office 버전을 사용하기 때문입니다. 설치된 Office 버전과 일치하는 프로젝트만 디자이너에서 열 수 있습니다.

문서 수준 사용자 지정 프로젝트를 업그레이드하려면 적절한 Office 응용 프로그램이 설치되어 있어야 합니다. 예를 들어 Word 2003 문서 수준 사용자 지정 프로젝트를 업그레이드하려면 컴퓨터에 Word 2003 또는 Word 2007이 설치되어 있어야 합니다.

2007 Microsoft Office system이 설치된 경우 Visual Studio 변환 마법사를 진행하는 중에 문서를 Open XML 형식 중 하나로 변환할지 여부를 선택해야 합니다. 이전 형식을 사용해야 하는 특별한 이유가 없으면 문서 형식을 변환해야 합니다. 이러한 형식에 대한 자세한 내용은 Introduction to new file name extensions and Open XML Formats를 참조하십시오.

Microsoft Office 2003이 설치된 경우 프로젝트를 업그레이드하면 해당 프로젝트에서는 계속해서 Microsoft Office 2003을 대상 버전으로 사용하며 문서 형식은 동일하게 유지됩니다.

Visual Studio Tools for Office, Version 2003을 사용하여 만든 문서 수준 프로젝트를 업그레이드할 경우 몇 가지 업그레이드 단계는 수동으로 수행해야 합니다. 자세한 내용은 Visual Studio Tools for Office 버전 2003에서 업그레이드를 참조하십시오.

응용 프로그램 수준 추가 기능 프로젝트

2007 Microsoft Office system이 설치되어 있고 Visual Studio 변환 마법사에서 버전 2003 추가 기능 프로젝트가 버전 2007 추가 기능 프로젝트로 업그레이드되지 않도록 하려는 경우 Office 2003 프로젝트가 유지되도록 기본값을 변경할 수 있습니다. Office 2007 릴리스에서는 Office 2003 추가 기능을 호스팅할 수 있으므로 Microsoft Office 2003이 설치되어 있지 않더라도 2003 프로젝트를 개발, 컴파일 및 테스트할 수 있습니다. 이렇게 하려면 프로젝트 업그레이드 옵션 페이지에서 설치된 Office 버전으로 항상 업그레이드합니다. 옵션의 선택을 취소합니다. 자세한 내용은 옵션 대화 상자, 프로젝트 업그레이드를 참조하십시오.

Visual Studio 변환 마법사에서는 추가 기능 프로젝트가 이전 버전의 Office와 호환되게 할 수 없습니다. 따라서 Office 2003이 설치된 상태에서 버전 2007 추가 기능 프로젝트를 업그레이드하면 업그레이드가 완료된 후에도 해당 프로젝트는 버전 2007 추가 기능 프로젝트로 남아 있습니다. 이 경우 프로젝트를 열고 추가 기능을 개발한 다음 코드를 컴파일할 수 있습니다. 그러나 Office 2003에서는 버전 2007 추가 기능을 호스팅하지 않으므로 추가 기능을 테스트할 수는 없습니다.

Microsoft Office가 설치되어 있지 않아도 응용 프로그램 수준 추가 기능 프로젝트를 업그레이드할 수 있습니다.

Outlook 프로젝트

Outlook 2003 추가 기능 프로젝트를 업그레이드할 경우 호스트 항목 클래스의 이름을 업데이트하고 Microsoft.Office.Interop.Outlook.Application 개체에 대한 참조를 업데이트해야 합니다.

참고:
Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System(VSTO 2005 SE) 프로젝트 템플릿을 사용하여 만든 프로젝트는 업데이트하지 않아도 됩니다.

호스트 항목 클래스 이름

Visual Studio 변환 마법사에서는 호스트 항목 클래스의 이름이 업데이트되지 않습니다. 따라서 클래스 이름이 계속 ThisApplication입니다. 이 이름을 변경할 필요는 없습니다. 그러나 Visual Studio Tools for the Office System 3.0 도움말 설명서의 코드 예제에서 사용하는 호스트 항목 클래스 이름은 ThisAddIn입니다. 이 코드 예제를 복사한 다음 프로젝트에 붙여 넣어 코드를 쉽게 테스트하려면 클래스 이름을 ThisAddIn으로 변경한 다음 프로젝트 전체에서 이 이름 변경 사항을 리팩터링하면 됩니다. C# 프로젝트에서 코드를 리팩터링하는 방법에 대한 자세한 내용은 방법: 식별자 이름 바꾸기를 참조하십시오. Visual Basic 프로젝트에서 코드를 리팩터링하는 방법에 대한 자세한 내용은 방법: 식별자 이름 바꾸기를 참조하십시오.

응용 프로그램 개체에 대한 참조

Visual Studio 변환 마법사에서는 코드를 수정하지 않습니다. 따라서 다음 기술 중 하나를 사용하여 Microsoft.Office.Interop.Outlook.Application 개체에 액세스하는 모든 코드를 수동으로 변경해야 합니다.

ThisApplication 클래스 내의 this(C#의 경우) 또는 Me(Visual Basic의 경우) 키워드
ThisApplication 클래스의 외부 코드에 있는 Globals.ThisApplication 개체

예를 들어 ThisApplication 클래스에 다음 코드가 들어 있으면 이 코드를 업데이트해야 합니다.

Me.ActiveExplorer()

this.ActiveExplorer();

다음 코드는 업그레이드된 프로젝트에서 대체 코드로 사용됩니다.

Me.Application.ActiveExplorer()

This.Application.ActiveExplorer();

Microsoft Visual Studio 2005 Tools for the Microsoft Office System 프로젝트의 ThisApplication 호스트 항목 클래스는 Microsoft.Office.Tools.Outlook.Application클래스에서 직접 상속합니다. 그러나 Visual Studio Tools for the Office System 3.0 프로젝트의 ThisAddIn 호스트 항목 클래스는 Microsoft.Office.Tools.Outlook.Application에서 상속하지 않습니다. 대신 호스트 항목 클래스의 Application 속성을 사용하여 활성 응용 프로그램 개체를 참조합니다.

2007 버전의 Microsoft Office로 업그레이드

Visual Studio Tools for Office 프로젝트를 업그레이드한 후 2007 버전의 Microsoft Office로 업그레이드할 경우 다음에 해당 프로젝트를 열면 Visual Studio 변환 마법사가 나타납니다.

Office 2003이 설치되어 있을 때 업그레이드하지 않기로 선택한 2007 버전의 Office용 추가 기능 프로젝트는 이제 실행되며, Visual Studio에서 F5 키나 Ctrl+F5를 눌러 이러한 프로젝트를 테스트할 수 있습니다.

참고 항목

다음을 통해 공유