Office 프로젝트의 이벤트

각 Office 프로젝트 템플릿은 몇 가지 이벤트 처리기를 자동으로 생성합니다. 문서 수준 사용자 지정의 이벤트 처리기는 VSTO 추가 기능의 이벤트 처리기와 약간 다릅니다.

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

문서 수준 프로젝트

Visual Studio에서는 문서 수준 사용자 지정의 신규 또는 기존 문서나 워크시트 뒤에서 생성된 코드를 제공합니다. 이 코드에서는 두 가지 이벤트인 Startup 및 Shutdown을 발생시킵니다.

Startup 이벤트

Startup 이벤트는 문서가 실행 중이고 어셈블리의 모든 초기화 코드가 실행된 후 각 호스트 항목(문서, 통합 문서 또는 워크시트)에 대해 발생합니다. 이 이벤트는 코드가 실행되고 있는 클래스의 생성자에서 실행될 마지막 항목입니다. 호스트 항목에 대한 자세한 내용은 호스트 항목 및 호스트 컨트롤 개요를 참조하세요.

문서 수준 프로젝트를 만드는 경우 Visual Studio에서는 생성된 코드 파일에서 Startup 이벤트에 대한 이벤트 처리기를 만듭니다.

• Microsoft Office Word 프로젝트에 대한 이벤트 처리기의 이름은 ThisDocument_Startup입니다.

• Microsoft Office Excel 프로젝트에 대한 이벤트 처리기의 이름은 다음과 같습니다.

  • Sheet1_Startup

  • Sheet2_Startup

  • Sheet3_Startup

  • ThisWorkbook_Startup

Shutdown 이벤트

Shutdown 이벤트는 코드가 로드된 애플리케이션 도메인이 언로드되려고 할 때 각 호스트 항목(문서 또는 워크시트)에 대해 발생합니다. 이 이벤트는 언로드될 때 클래스에서 호출되는 마지막 항목입니다.

문서 수준 프로젝트를 만드는 경우 Visual Studio에서는 생성된 코드 파일에서 Shutdown 이벤트에 대한 이벤트 처리기를 만듭니다.

• Microsoft Office Word 프로젝트에 대한 이벤트 처리기의 이름은 ThisDocument_Shutdown입니다.

• Microsoft Office Excel 프로젝트에 대한 이벤트 처리기의 이름은 다음과 같습니다.

  • Sheet1_Shutdown

  • Sheet2_Shutdown

  • Sheet3_Shutdown

  • ThisWorkbook_Shutdown

이벤트 처리기 메서드 선언

모든 이벤트 처리기 메서드 선언에는 동일한 인수인 sender 및 e가 전달됩니다. Excel에서 sender 인수는 Sheet1 , Sheet2등의 시트를 참조하고, Word에서 sender 인수는 문서를 참조합니다. e 인수는 이벤트의 표준 인수를 참조합니다. 이 경우에는 표준 인수가 사용되지 않습니다.

다음 코드 예제에서는 Word용 문서 수준 프로젝트의 기본 이벤트 처리기를 보여 줍니다.

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}

private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub ThisDocument_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

다음 코드 예제에서는 Excel용 문서 수준 프로젝트의 기본 이벤트 처리기를 보여 줍니다.

private void Sheet1_Startup(object sender, System.EventArgs e)
{
}

private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

End Sub

Private Sub Sheet1_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Shutdown

End Sub

문서 수준 Excel 프로젝트의 이벤트 순서

Excel 프로젝트의 Startup 이벤트 처리기는 다음 순서로 호출됩니다.

1. ThisWorkbook_Startup.

2. Sheet1_Startup.

3. Sheet2_Startup.

4. Sheet3_Startup.

5. 순서에 있는 다른 시트

   통합 문서 솔루션의 Shutdown 이벤트 처리기는 다음 순서로 호출됩니다.

6. ThisWorkbook_Shutdown.

7. Sheet1_Shutdown.

8. Sheet2_Shutdown.

9. Sheet3_Shutdown.

10. 순서에 있는 다른 시트

    순서는 프로젝트가 컴파일될 때 결정됩니다. 사용자가 런타임에 시트를 다시 정렬하는 경우 다음번에 통합 문서가 열리거나 닫힐 때 이벤트가 발생하는 순서는 변경되지 않습니다.

VSTO 추가 기능 프로젝트

Visual Studio는 VSTO 추가 기능에서 생성된 코드를 제공합니다. 이 코드는 두 가지 이벤트 Startup 및 Shutdown을 발생시킵니다.

Startup 이벤트

Startup 이벤트는 VSTO 추가 기능이 로드되고 어셈블리의 모든 초기화 코드가 실행된 후 발생합니다. 이 이벤트는 생성된 코드 파일의 ThisAddIn_Startup 메서드에서 처리됩니다.

VSTO 추가 기능이 ThisAddIn_Startup 메서드를 재정의하지 않는 한 RequestComAddInAutomationService 이벤트 처리기의 코드는 실행할 첫 번째 사용자 코드입니다. 이 경우에 ThisAddIn_Startup 이벤트 처리기는 RequestComAddInAutomationService뒤에 호출됩니다.

코드를 실행하려면 문서가 열려 있어야 하는 경우 ThisAdd-In_Startup 이벤트 처리기에서 코드를 추가하면 안 됩니다. 대신 사용자가 문서를 만들거나 열 때 Office 애플리케이션에서 발생하는 이벤트에 해당 코드를 추가합니다. 자세한 내용은 Office 애플리케이션이 시작될 때 문서 액세스를 참조하세요.

VSTO 추가 기능의 시작 시퀀스에 대한 자세한 내용은 VSTO 추가 기능 아키텍처를 참조하세요.

Shutdown 이벤트

Shutdown 이벤트는 코드가 로드된 애플리케이션 도메인이 언로드되려고 할 때 발생합니다. 이 이벤트는 생성된 코드 파일의 ThisAddIn_Shutdown 메서드에서 처리됩니다. 이 이벤트 처리기는 VSTO 추가 기능이 언로드될 때 실행할 마지막 사용자 코드입니다.

Outlook VSTO 추가 기능의 종료 이벤트

Shutdown 이벤트는 사용자가 Outlook에서 COM 추가 기능 대화 상자를 사용하여 VSTO 추가 기능을 사용하지 않도록 설정할 때만 발생합니다. 이 이벤트는 Outlook이 종료될 때 발생하지 않습니다. Outlook이 종료될 때 실행되어야 하는 코드가 있는 경우 다음 이벤트 중 하나를 처리합니다.

• Quit 개체의 Application 이벤트

• Close 개체의 Explorer 이벤트

관련 콘텐츠

• Office 솔루션 개발
• 방법: Visual Studio에서 Office 프로젝트 만들기
• 프로그램 문서 수준 사용자 지정
• 프로그램 VSTO 추가 기능
• Office 프로젝트 템플릿 개요