연습: Excel용 첫 문서 수준 사용자 지정 만들기

아티클
02/21/2013

이 기초 연습에서는 Microsoft Office Excel용 문서 수준 사용자 지정을 만드는 방법을 보여 줍니다.이러한 종류의 솔루션에서 만드는 기능은 특성 통합 문서가 열려 있을 때만 사용 가능합니다.문서 수준 사용자 지정을 사용하여 통합 문서가 열려 있을 때 새 리본 메뉴 탭을 표시하는 등의 응용 프로그램 수준 변경 작업을 수행할 수는 없습니다.

적용 대상: 이 항목의 정보는 Excel 2013 및 Excel 2010의 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

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

Excel 통합 문서 프로젝트 만들기
Visual Studio 디자이너에서 호스팅된 워크시트에 텍스트 추가
Excel의 개체 모델을 사용하여 사용자 지정 워크시트가 열려 있을 때 해당 워크시트에 텍스트를 추가하는 코드 작성
프로젝트 빌드, 실행 및 테스트
완성된 프로젝트를 정리하여 개발 컴퓨터에서 불필요한 빌드 파일 및 보안 설정 제거

[!참고]

다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

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

Microsoft Office 개발자 도구를 포함하는 Visual Studio 2012 버전입니다. 자세한 내용은 [Office 솔루션을 개발할 수 있도록 컴퓨터 구성](bb398242\(v=vs.110\).md)을 참조하십시오.

Excel 2013 또는 Excel 2010

프로젝트 만들기

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

Visual Studio를 시작합니다.
파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.
템플릿 창에서 확장 C# 또는 Visual Basic을 차례로 확장 하 고 OfficeSharePoint/.
아래 확장 된 Office/SharePoint 노드를 선택 된 Office 추가 기능 노드.
프로젝트 템플릿 목록에서 Excel 2010 통합 문서 또는 Excel 2013 통합 문서를 선택합니다.
이름 상자에 FirstWorkbookCustomization을 입력합니다.
확인을 클릭합니다.

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 코드 파일이 자동으로 열립니다.

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

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

디자이너에서 워크시트를 닫은 후 다시 열려면

디자이너 창의 닫기 단추(X)를 클릭하여 통합 문서를 닫습니다.
솔루션 탐색기에서 Sheet1 코드 파일을 마우스 오른쪽 단추로 클릭한 다음 디자이너 보기를 클릭합니다.

-또는-

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

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

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

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

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

This text was added by using the designer.

주의
A2 셀에 이 텍스트 줄을 추가할 경우 이 예제의 다른 코드에 의해 해당 셀이 덮어쓰여집니다.

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

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

워크시트의 프로그래밍 모델을 나타내며 Excel의 개체 모델에 액세스할 수 있게 해 주는 Sheet1 클래스의 부분 정의.자세한 내용은 워크시트 호스트 항목 및 Word 개체 모델 개요를 참조하십시오.Sheet1 클래스의 나머지 부분은 사용자가 수정할 수 없는 숨겨진 코드 파일에 정의되어 있습니다.
Sheet1_Startup 및 Sheet1_Shutdown 이벤트 처리기.이러한 이벤트 처리기는 Excel에서 사용자 지정이 로드 및 언로드될 때 호출됩니다.이러한 이벤트 처리기를 사용하여 사용자 지정이 로드될 때 사용자 지정을 초기화하고 사용자 지정이 언로드될 때 사용자 지정에서 사용한 리소스를 정리합니다.자세한 내용은 Office 프로젝트의 이벤트을 참조하십시오.

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

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

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

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

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

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";
}

프로젝트 테스트

통합 문서를 테스트하려면

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

프로젝트를 빌드하면 코드가 통합 문서와 연결된 어셈블리로 컴파일됩니다.또한 통합 문서의 복사본과 어셈블리가 프로젝트의 빌드 출력 폴더에 포함되고 개발 컴퓨터에서 사용자 지정을 실행할 수 있도록 하는 보안 설정이 구성됩니다.자세한 내용은 Office 솔루션 빌드을 참조하십시오.
통합 문서에서 다음 텍스트가 표시되는지 확인합니다.

This text was added by using the designer.

This text was added by using code.
통합 문서를 닫습니다.

프로젝트 정리

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

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

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

다음 단계

기본적인 Excel용 문서 수준 사용자 지정을 만들어 보았으므로 이제 다음 항목에서 사용자 지정을 개발하는 방법을 보다 자세히 배울 수 있습니다.

문서 수준 사용자 지정에서 수행할 수 있는 일반적인 프로그래밍 작업: 문서 수준 사용자 지정 프로그래밍
Excel용 문서 수준 사용자 지정과 관련된 프로그래밍 작업: Excel 솔루션
Excel의 개체 모델 사용: Excel 개체 모델 개요
리본 메뉴에 사용자 지정 탭을 추가하거나 사용자 고유의 작업 창을 만드는 등의 방법으로 Excel의 UI 사용자 지정: Office UI 사용자 지정
Visual Studio의 Office 개발 도구에서 제공하는 확장된 Excel 개체를 사용하여 Excel 개체 모델로는 가능하지 않은 작업 수행(예: 문서에서 관리되는 컨트롤 호스팅, Windows Forms 데이터 바인딩 모델을 사용하여 데이터에 Excel 컨트롤 바인딩 등): 확장된 개체를 사용하여 Excel 자동화
Excel용 문서 수준 사용자 지정 빌드 및 디버깅: Office 솔루션 빌드
Excel용 문서 수준 사용자 지정 배포: Office 솔루션 배포