ProjectItem 요소(Visual Studio 항목 템플릿)

아티클
01/13/2024

항목 템플릿에 포함된 파일을 지정합니다.

참고 항목

이 ProjectItem 요소는 템플릿이 프로젝트 또는 항목에 대한 것인지에 따라 다른 특성을 허용합니다. 이 항목에서는 항목의 ProjectItem 요소를 설명합니다. 프로젝트 템플릿의 ProjectItem 요소에 대한 설명은 ProjectItem 요소(Visual Studio 프로젝트 템플릿)를 참조하세요.

구문

<ProjectItem
    SubType="Form/Component/CustomControl/UserControl"
    CustomTool="string"
    ItemType="string"
    ReplaceParameters="true/false"
    TargetFileName="TargetFileName.ext">
        FileName.ext
</ProjectItem>

특성 및 요소

다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
`SubType`	선택적 특성입니다. 다중 파일 항목 템플릿에 있는 항목의 하위 형식을 지정합니다. 이 값은 Visual Studio에서 항목을 여는 데 사용할 편집기를 결정하는 데 사용됩니다.
`CustomTool`	선택적 특성입니다. 프로젝트 파일의 항목에 대한 CustomTool을 설정합니다.
`ItemType`	선택적 특성입니다. 프로젝트 파일의 항목에 대한 ItemType을 설정합니다.
`ReplaceParameters`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 대체해야 하는 매개 변수 값이 항목에 있는지 여부를 지정하는 부울 값입니다. 기본값은 `false`여야 합니다.
`TargetFileName`	선택적 특성입니다. 템플릿에서 만든 항목의 이름을 지정합니다. 이 특성은 매개 변수 대체를 사용하여 항목 이름을 만드는 데 유용합니다.

자식 요소

없음

부모 요소

요소	설명
TemplateContent	템플릿의 콘텐츠를 지정합니다.

텍스트 값

텍스트 값은 필수입니다.

템플릿 .zip 파일의 파일 이름을 나타내는 string입니다.

설명

ProjectItem은 TemplateContent의 선택적 자식입니다.

매개 변수를 사용하여 파일의 이름을 바꾸는 데 TargetFileName 특성을 사용할 수 있습니다. 예를 들어 MyFile.vb 파일이 템플릿 .zip 파일의 루트 디렉터리에 있지만 새 항목 추가 대화 상자에서 사용자가 제공한 파일 이름에 따라 파일의 이름을 지정하려는 경우 다음 XML을 사용합니다.

<ProjectItem TargetFileName="$fileinputname$.vb">MyFile.vb</ProjectItem>

이 템플릿에서 항목을 만들 때 파일 이름은 사용자가 새 항목 추가 대화 상자에 입력한 이름을 기반으로 합니다. 다중 파일 항목 템플릿을 만들 때 유용합니다. 자세한 내용은 방법: 다중 파일 항목 템플릿 만들기 및 템플릿 매개 변수를 참조하세요.

예시

다음 예제에서는 표준 Visual C# 클래스의 표준 항목 템플릿 메타데이터를 보여 줍니다.

<VSTemplate Type="Item" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <DefaultName>MyClass.cs</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem ReplaceParameters="true">MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>