다음을 통해 공유

단계별 안내: Excel을 위한 첫 문서 수준 사용자 지정 만들기

이 소개 연습에서는 Microsoft Office Excel에 대한 문서 수준 사용자 지정을 만드는 방법을 보여 줍니다. 이러한 종류의 솔루션에서 만드는 기능은 특정 통합 문서가 열려 있는 경우에만 사용할 수 있습니다. 문서 수준 사용자 지정을 사용하여 응용 프로그램 전체를 변경하려는 경우 변경할 수 없습니다. 예를 들어, 모든 통합 문서가 열려 있을 때 새 리본 탭을 표시하는 것과 같은 예입니다.

적용 대상: 이 항목의 정보는 Excel용 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 유형에서 사용할 수 있는 기능을 참조하세요.

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

  • Excel 통합 문서 프로젝트 만들기

  • Visual Studio 디자이너에서 호스트되는 워크시트에 텍스트를 추가합니다.

  • Excel의 개체 모델을 사용하여 열려 있는 경우 사용자 지정된 워크시트에 텍스트를 추가하는 코드를 작성합니다.

  • 프로젝트를 빌드하고 실행하여 테스트합니다.

  • 개발 컴퓨터에서 불필요한 빌드 파일 및 보안 설정을 제거하도록 완료된 프로젝트를 정리합니다.

    비고

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

필수 조건

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

프로젝트를 만듭니다.

Visual Studio에서 새 Excel 통합 문서 프로젝트를 만들려면

  1. Visual Studio를 시작합니다.

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

  3. 새 프로젝트 만들기 대화 상자에서 Excel VSTO 통합 문서 프로젝트를 선택합니다.

    비고

    새 프로젝트 만들기 대화 상자의 맨 위에 있는 검색 텍스트 상자에 Office 제품의 이름을 입력하여 서식 파일을 검색할 수도 있습니다. 예를 들어 Excel을 입력하면 Excel 에 대한 모든 프로젝트 템플릿이 표시됩니다. 프로젝트 유형 드롭다운 상자에서 Office 를 선택하여 Office용 서식 파일만 표시하도록 서식 파일 목록을 필터링할 수도 있습니다. 자세한 내용은 Visual Studio에서 새 프로젝트 만들기를 참조하세요.

  4. 다음을 클릭합니다.

  5. 새 프로젝트 구성 대화 상자의 이름 상자에 FirstWorkbookCustomization을 입력하고 만들기를 클릭합니다.

  6. Visual Studio Tools for Office 프로젝트 마법사에서 새 문서 만들기를 선택하고 확인을 클릭합니다.

    • Visual Studio는 FirstWorkbookCustomization 프로젝트를 만들고 프로젝트에 다음 파일을 추가합니다.

    • FirstWorkbookCustomization.xlsx - 프로젝트의 Excel 통합 문서를 나타냅니다. 모든 워크시트 및 차트를 포함합니다.

    • Sheet1(Visual Basic용 .vb 파일 또는 Visual C#용 .cs 파일) - 통합 문서의 첫 번째 워크시트에 대한 디자인 화면과 코드를 제공하는 워크시트입니다. 자세한 내용은 워크시트 호스트 항목을 참조하세요.

    • Sheet2(Visual Basic용 .vb 파일 또는 Visual C#용 .cs 파일) - 통합 문서의 두 번째 워크시트에 대한 디자인 화면과 코드를 제공하는 워크시트입니다.

    • Sheet3(Visual Basic용 .vb 파일 또는 Visual C#용 .cs 파일) - 통합 문서의 세 번째 워크시트에 대한 디자인 화면과 코드를 제공하는 워크시트입니다.

    • ThisWorkbook(Visual Basic용 .vb 파일 또는 Visual C#용 .cs 파일) - 통합 문서 수준 사용자 지정에 대한 디자인 화면 및 코드를 포함합니다. 자세한 내용은 통합 문서 호스트 항목을 참조하세요.

      Sheet1 코드 파일은 디자이너에서 자동으로 열립니다.

디자이너에서 워크시트 닫기 및 다시 열기

프로젝트를 개발하는 동안 디자이너에서 통합 문서 또는 워크시트를 의도적으로 또는 실수로 닫는 경우 다시 열 수 있습니다.

디자이너에서 워크시트를 닫고 다시 여려면

  1. 디자이너 창의 닫기 단추(X)를 클릭하여 통합 문서를 닫습니다.

  2. 솔루션 탐색기에서 Sheet1 코드 파일을 마우스 오른쪽 단추로 클릭하고 뷰 디자이너를 클릭합니다.

    - 또는 -

    솔루션 탐색기에서 Sheet1 코드 파일을 두 번 클릭합니다.

디자이너의 워크시트에 텍스트 추가

디자이너에서 열려 있는 워크시트를 수정하여 사용자 지정의 UI(사용자 인터페이스)를 디자인할 수 있습니다. 예를 들어 셀에 텍스트를 추가하거나, 수식을 적용하거나, Excel 컨트롤을 추가할 수 있습니다. 디자이너를 사용하는 방법에 대한 자세한 내용은 Visual Studio 환경의 Office 프로젝트를 참조하세요.

디자이너를 사용하여 워크시트에 텍스트를 추가하려면

  1. 디자이너에서 열려 있는 워크시트에서 A1 셀을 선택한 다음 다음 텍스트를 입력합니다.

    이 텍스트는 디자이너를 사용하여 추가되었습니다.

경고

이 텍스트 줄을 셀 A2에 추가하면 이 예제의 다른 코드에서 덮어씁니다.

프로그래밍 방식으로 워크시트에 텍스트 추가

다음으로 Sheet1 코드 파일에 코드를 추가합니다. 새 코드는 Excel의 개체 모델을 사용하여 통합 문서에 두 번째 텍스트 줄을 추가합니다. 기본적으로 Sheet1 코드 파일에는 다음과 같은 생성된 코드가 포함됩니다.

  • 워크시트의 프로그래밍 모델을 나타내고 Excel의 개체 모델에 대한 액세스를 제공하는 클래스의 부분 정의 Sheet1 입니다. 자세한 내용은 워크시트 호스트 항목 및 Word 개체 모델 개요를 참조하세요. 클래스의 Sheet1 나머지 부분에서는 수정해서는 안 되는 숨겨진 코드 파일에 정의됩니다.

  • Sheet1_Startup 및 Sheet1_Shutdown 이벤트 처리기입니다. 이러한 이벤트 처리기는 Excel에서 사용자 지정을 로드하고 언로드할 때 호출됩니다. 이러한 이벤트 처리기를 사용하여 로드될 때 사용자 지정을 초기화하고 언로드될 때 사용자 지정에서 사용하는 리소스를 정리합니다. 자세한 내용은 Office 프로젝트의 이벤트를 참조하세요.

코드를 사용하여 워크시트에 두 번째 텍스트 줄을 추가하려면

  1. 솔루션 탐색기에서 Sheet1을 마우스 오른쪽 단추로 클릭한 다음 코드 보기를 클릭합니다.

    코드 파일이 Visual Studio에서 열립니다.

  2. Sheet1_Startup 이벤트 처리기를 다음 코드로 바꿉다. Sheet1이 열리면 이 코드는 워크시트에 두 번째 텍스트 줄을 추가합니다.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

프로젝트 테스트

통합 문서를 테스트하려면

  1. F5 키를 눌러 프로젝트를 빌드하고 실행합니다.

    프로젝트를 빌드할 때 코드는 통합 문서와 연결된 어셈블리로 컴파일됩니다. Visual Studio는 프로젝트의 빌드 출력 폴더에 통합 문서 및 어셈블리의 복사본을 배치하고 사용자 지정을 실행할 수 있도록 개발 컴퓨터의 보안 설정을 구성합니다. 자세한 내용은 Office 솔루션 빌드를 참조하세요.

  2. 통합 문서에서 다음 텍스트가 표시되는지 확인합니다.

    이 텍스트는 디자이너를 사용하여 추가되었습니다.

    이 텍스트는 코드를 사용하여 추가되었습니다.

  3. 통합 문서를 닫습니다.

프로젝트 정리

프로젝트 개발을 마치면 빌드 출력 폴더의 파일과 빌드 프로세스에서 만든 보안 설정을 제거해야 합니다.

개발 컴퓨터에서 완료된 프로젝트를 정리하려면

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

다음 단계

이제 Excel에 대한 기본 문서 수준 사용자 지정을 만들었으므로 다음 항목에서 사용자 지정을 개발하는 방법에 대해 자세히 알아볼 수 있습니다.

관련 콘텐츠

  • Last updated on