연습: Project용 첫 VSTO 추가 기능 만들기

  • 아티클

이 연습에서는 Microsoft Office Project용 VSTO 추가 기능을 만드는 방법을 보여 줍니다. 이러한 종류의 솔루션에서 만드는 기능은 열려 있는 프로젝트에 관계없이 애플리케이션 자체에서 사용할 수 있습니다. 자세한 내용은 VSTO(Office 솔루션 개발 개요)를 참조하세요.

적용 대상: 이 항목의 정보는 Project의 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

이 연습에서는 다음 작업을 수행합니다.

  • Project VSTO 추가 기능 프로젝트 만들기

  • 새 프로젝트에 작업을 추가하기 위해 Project의 개체 모델을 사용하는 코드 작성

  • 테스트를 위해 프로젝트 빌드 및 실행

  • VSTO 추가 기능이 개발 컴퓨터에서 더 이상 자동으로 실행되지 않도록 하기 위해 완료된 프로젝트 정리

    참고 항목

    일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 IDE 개인 설정을 참조하세요.

필수 조건

이 연습을 완료하려면 다음과 같은 구성 요소가 필요합니다.

프로젝트 만들기

Visual Studio에서 새 프로젝트를 만들려면

  1. Visual Studio를 시작합니다.

  2. 파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.

  3. 템플릿 창에서 Visual C# 또는 Visual Basic을 확장한 다음 Office/SharePoint를 확장합니다.

  4. 확장된 Office/SharePoint 노드 아래에서 Office 추가 기능 노드를 선택합니다.

  5. 프로젝트 템플릿 목록에서 Project 2010 추가 기능 또는 Project 2013 추가 기능을 선택합니다.

  6. 이름 상자에 FirstProjectAddIn을 입력합니다.

  7. 확인을 클릭합니다.

    Visual Studio가 FirstProjectAddIn 프로젝트를 만들고 편집기에서 ThisAddIn 코드 파일을 엽니다.

프로젝트에 새 작업을 추가하는 코드 작성

다음 작업으로, ThisAddIn 코드 파일에 코드를 추가합니다. 새 코드는 Project의 개체 모델을 사용하여 프로젝트에 새 작업을 추가합니다. 기본적으로 ThisAddIn 코드 파일에는 다음과 같은 생성된 코드가 포함되어 있습니다.

  • ThisAddIn 클래스의 부분 정의. 이 클래스는 코드의 진입점을 제공하고 Project의 개체 모델에 대한 액세스를 제공합니다. 자세한 내용은 프로그램 VSTO 추가 기능을 참조하세요. ThisAddIn 클래스의 나머지 부분은 수정해서는 안 되는 숨김 코드 파일에서 정의됩니다.

  • ThisAddIn_Startup 및 ThisAddIn_Shutdown 이벤트 처리기. 이러한 이벤트 처리기는 Project에서 VSTO 추가 기능을 로드하고 언로드할 때 호출됩니다. 이러한 이벤트 처리기를 사용하여 VSTO 추가 기능이 로드될 때 VSTO 추가 기능을 초기화하고 VSTO 추가 기능이 언로드될 때 VSTO 추가 기능에서 사용하는 리소스를 정리할 수 있습니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.

작업을 새 프로젝트에 추가하려면

  1. ThisAddIn 코드 파일에서 다음 코드를 ThisAddIn 클래스에 추가합니다. 이 코드는 Microsoft.Office.Interop.MSProject.Application 클래스의 NewProject 이벤트에 대한 이벤트 처리기를 정의합니다.

    사용자가 새 프로젝트를 만들 때 이 이벤트 처리기는 작업을 프로젝트에 추가합니다.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    프로젝트를 수정하기 위해 이 코드 예제에서는 다음 개체를 사용합니다.

  • Application 클래스의 ThisAddIn 필드. Application 필드는 Project의 현재 인스턴스를 나타내는 Microsoft.Office.Interop.MSProject.Application 개체를 반환합니다.

  • NewProject 이벤트에 대한 이벤트 처리기의 pj 매개 변수입니다. pj 매개 변수는 프로젝트를 나타내는 Microsoft.Office.Interop.MSProject.Project 개체입니다. 자세한 내용은 Project 솔루션을 참조하세요.

  1. C#을 사용하는 경우 다음 코드를 ThisAddIn_Startup 이벤트 처리기에 추가합니다. 이 코드는 Application_Newproject 이벤트 처리기를 NewProject 이벤트와 연결합니다.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

프로젝트 테스트

프로젝트를 빌드하고 실행할 때 새 작업이 새 결과 프로젝트에 나타나는지 확인합니다.

프로젝트를 테스트하려면

  1. F5 키를 눌러 프로젝트를 빌드하고 실행합니다. Microsoft Project가 시작되고 새 빈 프로젝트가 자동으로 열립니다.

    프로젝트를 빌드하면 코드가 프로젝트의 빌드 출력 폴더에 포함된 어셈블리로 컴파일됩니다. 또한 Visual Studio에서는 Project에서 VSTO 추가 기능을 검색하고 로드할 수 있도록 하는 레지스트리 항목 집합을 만들고 VSTO 추가 기능이 실행될 수 있도록 개발 컴퓨터에서 보안 설정을 구성합니다. 자세한 내용은 Office 솔루션 빌드 프로세스 개요를 참조하세요.

  2. 새 작업이 빈 프로젝트에 추가되었는지 확인합니다.

  3. 다음 텍스트가 해당 작업의 작업 이름 필드에 표시되는지 확인합니다.

    This text was added by using code.

  4. Microsoft Project를 닫습니다.

프로젝트 정리

프로젝트의 개발을 완료하면 VSTO 추가 기능 어셈블리, 레지스트리 항목 및 보안 설정을 개발 컴퓨터에서 제거합니다. 이렇게 하지 않으면 개발 컴퓨터에서 Microsoft Project를 열 때마다 VSTO 추가 기능이 실행됩니다.

프로젝트를 정리하려면

  1. Visual Studio의 빌드 메뉴에서 솔루션 정리를 클릭합니다.

다음 단계

기본적인 Project용 VSTO 추가 기능을 만들었으므로 다음 항목에서 VSTO 추가 기능을 개발하는 방법에 대해 자세히 알아볼 수 있습니다.

관련 콘텐츠