연습: Excel 용 첫 문서 수준 사용자 지정 만들기Walkthrough: Create your first document-level customization for Excel

이 소개용 연습에서는 Microsoft Office Excel에 대한 문서 수준 사용자 지정을 만드는 방법을 보여 줍니다.This introductory walkthrough shows you how to create a document-level customization for Microsoft Office Excel. 이러한 종류의 솔루션에서 만드는 기능은 특정 통합 문서가 열려 있는 경우에만 사용할 수 있습니다.The features that you create in this kind of solution are available only when a specific workbook is open. 통합 문서가 열려 있을 때 새 리본 탭 표시와 같은 애플리케이션 수준 변경은 문서 수준 사용자 지정을 사용하여 수행할 수 없습니다.You cannot use a document-level customization to make application-wide changes, for example, displaying a new Ribbon tab when any workbook is open.

**** 적용 대상-: 이 항목의 정보는 Excel의 문서 수준 프로젝트에 적용됩니다.Applies to: The information in this topic applies to document-level projects for Excel. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조 하세요.For more information, see Features available by Office application and project type.

이 연습에서는 다음 작업을 수행합니다.This walkthrough illustrates the following tasks:

  • Excel 통합 문서 프로젝트 만들기Creating an Excel workbook project.

  • Visual Studio 디자이너에 호스트된 워크시트에 텍스트 추가Adding text to a worksheet that is hosted in the Visual Studio designer.

  • Excel의 개체 모델을 사용하여 사용자 지정 워크시트가 열릴 때 워크시트에 텍스트를 추가하는 코드 작성Writing code that uses the object model of Excel to add text to the customized worksheet when it is opened.

  • 테스트를 위해 프로젝트 빌드 및 실행Building and running the project to test it.

  • 완료된 프로젝트를 정리하여 개발 컴퓨터에서 불필요한 빌드 파일 및 보안 설정 제거Cleaning up the completed project to remove unnecessary build files and security settings from your development computer.

    참고

    일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다.The Visual Studio edition that you have and the settings that you use determine these elements. 자세한 내용은 IDE 개인 설정을 참조하세요.For more information, see Personalize the IDE.

필수 구성 요소Prerequisites

이 연습을 완료하려면 다음과 같은 구성 요소가 필요합니다.You need the following components to complete this walkthrough:

프로젝트 만들기Create the project

Visual Studio에서 새 Excel 통합 문서 프로젝트를 만들려면To create a new Excel workbook project in Visual Studio

  1. Visual StudioVisual Studio를 시작합니다.Start Visual StudioVisual Studio.

  2. 파일 메뉴에서 새로 만들기 를 가리킨 다음 프로젝트 를 클릭합니다.On the File menu, point to New, and then click Project.

  1. 템플릿 창에서 Visual C# 또는 Visual Basic 을 확장한 다음 Office/SharePoint 를 확장합니다.In the templates pane, expand Visual C# or Visual Basic, and then expand Office/SharePoint.

  2. 확장 된 Office/SharePoint 노드 아래에서 VSTO 추가 기능 노드를 선택 합니다.Under the expanded Office/SharePoint node, select the VSTO Add-ins node.

  3. 프로젝트 템플릿 목록에서 Excel VSTO 통합 문서 프로젝트를 선택 합니다.In the list of project templates, choose an Excel VSTO Workbook project.

  4. 이름 상자에 first통합 사용자 지정 을 입력 합니다.In the Name box, type FirstWorkbookCustomization.

  5. 확인 을 클릭합니다.Click OK.

  6. Visual Studio Tools for Office 프로젝트 마법사 에서 새 문서 만들기 를 선택 하 고 확인 을 클릭 합니다.Select Create a new document from the Visual Studio Tools for Office Project Wizard, and click OK.

  1. 새 프로젝트 만들기 대화 상자에서 Excel VSTO 통합 문서 프로젝트를 선택 합니다.On the Create a New Project dialog select the Excel VSTO Workbook project.

    참고

    새 프로젝트 만들기 대화 상자의 맨 위에 있는 검색 텍스트 상자에 Office 제품의 이름을 입력 하 여 템플릿을 검색할 수도 있습니다.You can also search for templates by typing the name of the Office product in the Search text box at the top of the Create a New Project dialog. 예를 들어 excel 을 입력 하면 excel 용 프로젝트 템플릿이 모두 표시 됩니다.For example, typing Excel will show you all of the project templates for Excel. 프로젝트 형식 드롭다운 상자에서 office 를 선택 하 여 office 용 템플릿만 표시 하도록 템플릿 목록을 필터링 할 수도 있습니다.You can also filter the list of templates to show only the templates for Office by selecting Office in the Project type dropdown box. 자세한 내용은 Visual Studio에서 새 프로젝트 만들기를 참조 하세요.For more information see Create a new project in Visual Studio.

  2. 다음 을 클릭합니다.Click Next.

  3. 새 프로젝트 구성 대화 상자의 이름 상자에 first통합 사용자 지정 을 입력 하 고 만들기 를 클릭 합니다.Type FirstWorkbookCustomization in the Name box on the Configure your new project dialog and click Create.

  4. Visual Studio Tools for Office 프로젝트 마법사 에서 새 문서 만들기 를 선택 하 고 확인 을 클릭 합니다.Select Create a new document from the Visual Studio Tools for Office Project Wizard, and click OK.

  • Visual StudioVisual StudioFirst통합 문서의 사용자 지정 프로젝트를 만들고 프로젝트에 다음 파일을 추가 합니다.creates the FirstWorkbookCustomization project, and adds the following files to the project.

  • Firstworkbook 사용자 지정.xlsx-프로젝트의 Excel 통합 문서를 나타냅니다.FirstWorkbookCustomization.xlsx - Represents the Excel workbook in the project. 모든 워크시트 및 차트를 포함합니다.Contains all the worksheets and charts.

  • Sheet1 (Visual Basic의 경우 .vb 파일 또는 Visual c #의 경우 .cs 파일)-통합 문서의 첫 번째 워크시트에 대 한 디자인 화면 및 코드를 제공 하는 워크시트입니다.Sheet1 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the first worksheet in the workbook. 자세한 내용은 워크시트 호스트 항목을 참조 하세요.For more information, see Worksheet host item.

  • Sheet2 (Visual Basic의 경우 .vb 파일 또는 Visual c #의 경우 .cs 파일)-통합 문서의 두 번째 워크시트에 대 한 디자인 화면 및 코드를 제공 하는 워크시트입니다.Sheet2 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the second worksheet in the workbook.

  • Sheet3 (Visual Basic의 경우 .vb 파일 또는 Visual c #의 경우 .cs 파일)-통합 문서의 세 번째 워크시트에 대 한 디자인 화면 및 코드를 제공 하는 워크시트입니다.Sheet3 (.vb file for Visual Basic or .cs file for Visual C#) - A worksheet that provides the design surface and the code for the third worksheet in the workbook.

  • ThisWorkbook (Visual Basic의 경우 .vb 파일 또는 Visual c #의 경우 .cs 파일)-통합 문서 수준 사용자 지정을 위한 디자인 화면 및 코드를 포함 합니다.ThisWorkbook (.vb file for Visual Basic or .cs file for Visual C#) - Contains the design surface and the code for workbook-level customizations. 자세한 내용은 통합 문서 호스트 항목을 참조 하세요.For more information, see Workbook host item.

    Sheet1 코드 파일이 디자이너에서 자동으로 열립니다.The Sheet1 code file is opened automatically in the designer.

디자이너에서 워크시트를 닫았다가 다시 엽니다.Close and reopen worksheets in the designer

프로젝트를 개발하는 동안 디자이너에서 의도적으로 또는 실수로 통합 문서 또는 워크시트를 닫은 경우 다시 열 수 있습니다.If you deliberately or accidentally close a workbook or a worksheet in the designer while you are developing your project, you can reopen it.

디자이너에서 워크시트를 닫았다가 다시 열려면To close and reopen a worksheet in the designer

  1. 디자이너 창의 닫기 단추 (X)를 클릭 하 여 통합 문서를 닫습니다.Close the workbook by clicking the Close button (X) for the designer window.

  2. 솔루션 탐색기 에서 Sheet1 코드 파일을 마우스 오른쪽 단추로 클릭 하 고 디자이너 보기 를 클릭 합니다.In Solution Explorer, right-click the Sheet1 code file, and click View Designer.

    - 또는 -- or -

    솔루션 탐색기 에서 Sheet1 코드 파일을 두 번 클릭 합니다.In Solution Explorer, double-click the Sheet1 code file.

디자이너에서 워크시트에 텍스트 추가Add text to a worksheet in the designer

디자이너에서 열려 있는 워크시트를 수정하여 사용자 지정의 UI(사용자 인터페이스)를 디자인할 수 있습니다.You can design the user interface (UI) of your customization by modifying the worksheet that is open in the designer. 예를 들어 셀에 텍스트를 추가하거나, 수식을 적용하거나, Excel 컨트롤을 추가할 수 있습니다.For example, you can add text to cells, apply formulas, or add Excel controls. 디자이너를 사용 하는 방법에 대 한 자세한 내용은 Visual Studio 환경의 Office 프로젝트를 참조 하세요.For more information about how to use the designer, see Office projects in the Visual Studio environment.

디자이너를 사용하여 워크시트에 텍스트를 추가하려면To add text to a worksheet by using the designer

  1. 디자이너에 열려 있는 워크시트에서 A1 셀을 선택 하 고 다음 텍스트를 입력 합니다.In the worksheet that is open in the designer, select cell A1, and then type the following text.

    This text was added by using the designer.This text was added by using the designer.

경고

이 텍스트 줄을 A2 셀에 추가 하는 경우이 예제에서 다른 코드를 통해 덮어씁니다.If you add this line of text to cell A2, it will be overwritten by other code in this example.

프로그래밍 방식으로 워크시트에 텍스트 추가Add text to a worksheet programmatically

다음에는 Sheet1 코드 파일에 코드를 추가합니다.Next, add code to the Sheet1 code file. 새 코드는 Excel의 개체 모델을 사용하여 통합 문서에 두 번째 텍스트 줄을 추가합니다.The new code uses the object model of Excel to add a second line of text to the workbook. 기본적으로 Sheet1 코드 파일에는 다음과 같은 생성된 코드가 포함됩니다.By default, the Sheet1 code file contains the following generated code:

  • 워크시트의 프로그래밍 모델을 나타내고 Excel의 개체 모델에 대한 액세스를 제공하는 Sheet1 클래스의 부분 정의입니다.A partial definition of the Sheet1 class, which represents the programming model of the worksheet and provides access to the object model of Excel. 자세한 내용은 워크시트 호스트 항목Word 개체 모델 개요를.For more information, Worksheet host item and Word object model overview. Sheet1 클래스의 나머지 부분은 수정해서는 안 되는 숨김 코드 파일에서 정의됩니다.The remainder of the Sheet1 class is defined in a hidden code file that you should not modify.

  • Sheet1_StartupSheet1_Shutdown 이벤트 처리기.The Sheet1_Startup and Sheet1_Shutdown event handlers. 이러한 이벤트 처리기는 Excel에서 사용자 지정을 로드하고 언로드할 때 호출됩니다.These event handlers are called when Excel loads and unloads your customization. 이러한 이벤트 처리기를 사용하여 사용자 지정이 로드될 때 사용자 지정을 초기화하고 사용자 지정이 언로드될 때 사용자 지정에서 사용하는 리소스를 정리할 수 있습니다.Use these event handlers to initialize your customization when it is loaded, and to clean up resources used by your customization when it is unloaded. 자세한 내용은 Office 프로젝트의 이벤트를 참조 하세요.For more information, see Events in Office projects.

코드를 사용하여 워크시트에 두 번째 텍스트 줄을 추가하려면To add a second line of text to the worksheet by using code

  1. 솔루션 탐색기 에서 Sheet1 을 마우스 오른쪽 단추로 클릭 한 다음 코드 보기 를 클릭 합니다.In Solution Explorer, right-click Sheet1, and then click View Code.

    Visual Studio에서 코드 파일이 열립니다.The code file opens in Visual Studio.

  2. Sheet1_Startup 이벤트 처리기를 다음 코드로 바꿉니다.Replace the Sheet1_Startup event handler with the following code. Sheet1이 열릴 때 이 코드는 워크시트에 두 번째 텍스트 줄을 추가합니다.When Sheet1 is opened, this code adds a second line of text to the worksheet.

    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";
    }
    
    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
        Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
            Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
        nr.Value2 = "This text was added by using code"
    End Sub
    

프로젝트 테스트Test the project

통합 문서를 테스트하려면To test your workbook

  1. F5 키를 눌러 프로젝트를 빌드하고 실행합니다.Press F5 to build and run your project.

    프로젝트를 빌드하면 코드가 통합 문서와 연결된 어셈블리로 컴파일됩니다.When you build the project, the code is compiled into an assembly that is associated with the workbook. Visual Studio는 프로젝트에 대한 빌드 출력 폴더에 통합 문서와 어셈블리의 복사본을 넣고 사용자 지정을 실행할 수 있도록 개발 컴퓨터의 보안 설정을 구성합니다.Visual Studio puts a copy of the workbook and the assembly in the build output folder for the project, and it configures the security settings on the development computer to enable the customization to run. 자세한 내용은 Office 솔루션 빌드를 참조 하세요.For more information, see Build Office solutions.

  2. 통합 문서에서 다음 텍스트가 표시되는지 확인합니다.In the workbook, verify that you see the following text.

    This text was added by using the designer.This text was added by using the designer.

    This text was added by using code.This text was added by using code.

  3. 통합 문서를 닫습니다.Close the workbook.

프로젝트 정리Clean up the project

프로젝트 개발을 완료하면 빌드 출력 폴더의 파일 및 빌드 프로세스에서 생성된 보안 설정을 제거해야 합니다.When you finish developing a project, you should remove the files in the build output folder and the security settings created by the build process.

개발 컴퓨터에서 완료된 프로젝트를 정리하려면To clean up the completed project on your development computer

  1. Visual Studio의 빌드 메뉴에서 솔루션 정리 를 클릭합니다.In Visual Studio, on the Build menu, click Clean Solution.

다음 단계Next steps

기본적인 Excel용 문서 수준 사용자 지정을 만들었으므로 다음 항목에서 사용자 지정을 개발하는 방법에 대해 자세히 알아볼 수 있습니다.Now that you have created a basic document-level customization for Excel, you can learn more about how to develop customizations from these topics:

  • 문서 수준 사용자 지정에서 수행할 수 있는 일반적인 프로그래밍 작업: 문서 수준 사용자 지정프로그래밍.General programming tasks that you can perform in document-level customizations: Program document-level customizations.

  • Excel 용 문서 수준 사용자 지정과 관련 된 프로그래밍 작업: excel 솔루션.Programming tasks that are specific to document-level customizations for Excel: Excel solutions.

  • Excel 개체 모델 사용: excel 개체 모델 개요Using the object model of Excel: Excel object model overview.

  • 예를 들어, 리본 메뉴에 사용자 지정 탭을 추가 하거나 사용자 고유의 작업 창 ( OFFICE ui 사용자 지정)을 만들어 EXCEL의 ui를 사용자 지정할 수 있습니다.Customizing the UI of Excel, for example, by adding a custom tab to the Ribbon or creating your own actions pane: Office UI customization.

  • Visual Studio의 Office 개발 도구에서 제공 하는 확장 된 Excel 개체를 사용 하 여 Excel 개체 모델을 사용 하 여 불가능 한 작업 수행 (예: 문서에서 관리 되는 컨트롤 호스팅 및 Windows Forms 데이터 바인딩 모델을 사용 하 여 Excel 컨트롤을 데이터에 바인딩): 확장 된 개체를 사용 하 여 Excel 자동화Using extended Excel objects provided by Office development tools in Visual Studio to perform tasks that are not possible by using the Excel object model (for example, hosting managed controls on documents and binding Excel controls to data by using the Windows Forms data binding model): Automate Excel by using extended objects.

  • Excel 용 문서 수준 사용자 지정 빌드 및 디버그: Office 솔루션 빌드Building and debugging document-level customizations for Excel: Build Office solutions.

  • Excel 용 문서 수준 사용자 지정 배포: Office 솔루션을 배포합니다.Deploying document-level customizations for Excel: Deploy an Office solution.

참고 항목See also