방법: 항목 템플릿 만들기How to: Create item templates

이 문서에서는 템플릿 내보내기 마법사를 사용하여 항목 템플릿을 만드는 방법을 보여줍니다.This article shows you how to create an item template by using the Export Template Wizard. 템플릿이 여러 파일로 구성되는 경우 방법: 다중 파일 항목 템플릿 만들기를 참조하세요.If your template will consist of multiple files, see How to: Create multi-file item templates.

사용자 항목 템플릿을 새 항목 추가 대화 상자에 추가하려면To add a user item template to the Add New Item dialog box

  1. Visual Studio에서 프로젝트를 만들거나 엽니다.Create or open a project in Visual Studio.

  2. 프로젝트에 항목을 추가한 후 원하는 경우 수정합니다.Add an item to the project, and modify it if you want to.

  3. 매개 변수를 대체해야 하는 위치를 나타내도록 코드 파일을 수정합니다.Modify the code file to indicate where parameter replacement should take place. 자세한 내용은 방법: 템플릿 매개 변수 대체를 참조하세요.For more information, see How to: Substitute parameters in a template.

  4. 프로젝트 메뉴에서 템플릿 내보내기를 선택합니다.On the Project menu, choose Export Template.

  5. 템플릿 형식 선택 페이지에서 선택 항목 템플릿을 선택하고 해당 항목을 포함하는 프로젝트를 선택하고 다음을 선택합니다.On the Choose Template Type page, choose Item Template, select the project that contains the item, and then choose Next.

  6. 내보낼 항목 선택 페이지에서 템플릿을 만들 항목을 선택한 후 다음을 선택합니다.On the Select Item To Export page, choose the item you want to create a template for, and then choose Next.

  7. 항목 참조 선택 페이지에서 템플릿에 포함할 어셈블리 참조를 선택한 후 다음을 선택합니다.On the Select Item References page, select the assembly references to include in the template, and then choose Next.

  8. 템플릿 옵션 선택 페이지에서, 템플릿 이름 및 설명(옵션), 아이콘 이미지 및 미리 보기 이미지를 입력한 다음 마침을 선택합니다.On the Select Template Options page, enter the template name and optional description, icon image and preview image, and then choose Finish.

    템플릿 파일은 .zip 파일에 추가되고 마법사에서 지정한 디렉터리에 복사됩니다.The files for the template are added to a .zip file and copied to the directory you specified in the wizard. 기본 위치는 %USERPROFILE%\Documents\Visual Studio <버전>\My Exported Templates입니다.The default location is %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

  9. 템플릿 내보내기 마법사에서 템플릿을 자동으로 Visual Studio로 가져오기 옵션을 선택하지 않은 경우 내보낸 템플릿을 찾습니다.If you did not select the option Automatically import the template into Visual Studio in the Export Template Wizard, locate the exported template. 그런 다음, 사용자 항목 템플릿 디렉터리에 복사합니다.Then, copy it to the user item template directory. 기본 위치는 %USERPROFILE%\Documents\Visual Studio <버전>\Templates\ItemTemplates입니다.The default location is %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

  10. Visual Studio를 종료한 다음 다시 엽니다.Close Visual Studio and then reopen it.

  11. 새 프로젝트를 만들거나 기존 프로젝트를 연 다음, 프로젝트 > 새 항목 추가를 선택하거나 Ctrl+Shift+A를 누릅니다.Create a new project, or open an existing project, and then choose Project > Add New Item or press Ctrl+Shift+A.

    새 항목 추가 대화 상자에 항목 템플릿이 나타납니다.The item template appears in the Add New Item dialog box. 템플릿 내보내기 마법사에서 설명을 추가한 경우 대화 상자의 오른쪽에 설명이 나타납니다.If you added a description in the Export Template Wizard, the description appears on the right side of the dialog box.

항목 템플릿을 유니버설 Windows 앱 프로젝트에서 사용할 수 있도록 하려면To enable the item template to be used in a Universal Windows App project

마법사에서 기본 템플릿 만들기에 대한 많은 작업을 수행하지만 대부분의 경우 템플릿을 내보낸 후 .vstemplate 파일을 수동으로 수정해야 합니다.The wizard does much of the work to create a basic template, but in many cases you need to manually modify the .vstemplate file after you have exported the template. 예를 들어 항목을 유니버설 Windows 앱 프로젝트의 새 항목 추가 대화 상자에 표시하려면 몇 가지 추가 단계를 수행해야 합니다.For example, if you want the item to appear in the Add New Item dialog for a Universal Windows App project, you have to perform a few extra steps.

  1. 이전 섹션의 단계에 따라 항목 템플릿을 내보냅니다.Follow the steps in the previous section to export an item template.

  2. 생성된 .zip 파일을 추출하고, Visual Studio에서 .vstemplate 파일을 엽니다.Extract the .zip file that was created, and open the .vstemplate file in Visual Studio.

  3. C# 유니버설 Windows 프로젝트의 경우 <TemplateData> 요소 내에 다음과 같은 XML을 추가합니다.For a C# Universal Windows project, add the following XML inside the <TemplateData> element:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>
    
  4. Visual Studio에서 .vstemplate 파일을 저장한 다음, 닫습니다.In Visual Studio, save the .vstemplate file and close it.

  5. .zip 파일에 .vstemplate 파일을 다시 복사하여 붙여넣습니다.Copy and paste the .vstemplate file back to the .zip file.

    파일 복사 대화 상자가 나타나면 복사하는 파일로 대상 파일 덮어쓰기 옵션을 선택합니다.If the Copy File dialog box appears, choose the Copy and Replace option.

이제 새 항목 추가 대화 상자에서 이 템플릿을 기반으로 한 항목을 유니버설 Windows 프로젝트에 추가할 수 있습니다.You can now add an item based on this template to a Universal Windows project from the Add New Item dialog box.

특정 프로젝트 하위 형식에 템플릿을 사용하도록 설정하려면To enable templates for specific project subtypes

Windows, Office, 대시보드 또는 웹과 같은 특정 프로젝트 하위 유형에만 템플릿이 표시되도록 지정할 수 있습니다.You can specify that your template should only appear for only certain project subtypes, such as Windows, Office, Database, or Web.

  1. .vstemplate 파일에서 항목 템플릿에 대한 ProjectType 요소를 찾습니다.Locate the ProjectType element in the .vstemplate file for the item template.

  2. ProjectSubType 요소 바로 뒤에 ProjectType 요소를 추가합니다.Add a ProjectSubType element immediately after the ProjectType element.

  3. 요소의 텍스트 값을 다음 값 중 하나로 설정합니다.Set the text value of the element to one of the following values:

    • WindowsWindows
    • OfficeOffice
    • 데이터베이스Database
    • Web

예: <ProjectSubType>Database</ProjectSubType>For example: <ProjectSubType>Database</ProjectSubType>.

다음 예제에서는 Office 프로젝트용 항목 템플릿을 보여줍니다.The following example shows an item template for Office projects.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

템플릿 내보내기 마법사를 사용하지 않고 항목 템플릿을 수동으로 만들려면To manually create an item template without using the Export Template wizard

경우에 따라 항목 템플릿을 처음부터 수동으로 만들 수 있습니다.In some cases you may want to create an item template manually, from scratch.

  1. 프로젝트 및 프로젝트 항목을 만듭니다.Create a project and project item.

  2. 템플릿으로 저장할 준비가 될 때까지 프로젝트 항목을 수정합니다.Modify the project item until it is ready to be saved as a template.

  3. 해당되는 경우 매개 변수를 대체해야 하는 위치를 나타내도록 코드 파일을 수정합니다.Modify the code file to indicate where parameter replacement should occur, if anywhere. 매개 변수 대체에 대한 자세한 내용은 방법: 템플릿에서 매개 변수 대체를 참조하세요.For more information about parameter replacement, see How to: Substitute parameters in a template.

  4. XML 파일을 만들고 .vstemplate 파일 확장명을 사용하여 프로젝트 항목 파일과 같은 디렉터리에 저장합니다.Create an XML file and save it with a .vstemplate file extension in the same directory as your project item file.

  5. 항목 템플릿 메타데이터를 제공하도록 .vstemplate XML 파일을 편집합니다.Edit the .vstemplate XML file to provide item template metadata. 자세한 내용은 템플릿 스키마 참조(확장성) 및 이전 섹션의 예제를 참조하세요.For more information, see Template schema reference (extensibility) and the example in the previous section.

  6. .vstemplate 파일을 저장한 다음, 닫습니다.Save the .vstemplate file and close it.

  7. Windows 탐색기에서 템플릿에 포함하려는 파일을 선택합니다.In Windows Explorer, select the files you want to include in your template. 마우스 오른쪽 단추를 클릭한 다음, 보내기 > 압축(ZIP) 폴더를 선택합니다.Right-click the selection, and choose Send to > Compressed (zipped) folder. 선택한 파일이 .zip 파일로 압축됩니다.The files that you selected are compressed into a .zip file.

  8. .zip 파일을 복사하여 사용자 항목 템플릿 위치에 붙여넣습니다.Copy the .zip file and paste it in the user item template location. Visual Studio 2017에서 기본 디렉터리는 %USERPROFILE%\Documents\Visual Studio 2017\Templates\ItemTemplates입니다.In Visual Studio 2017, the default directory is %USERPROFILE%\Documents\Visual Studio 2017\Templates\ItemTemplates. 자세한 내용은 방법: 프로젝트 템플릿과 항목 템플릿 찾기 및 구성을 참조하세요.For more information, see How to: Locate and organize project and item templates.

참고 항목See also