ProjectItem 요소(Visual Studio 프로젝트 템플릿)

아티클
01/13/2024

프로젝트 템플릿에 포함된 파일을 지정합니다.

참고 항목

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

구문

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        FileName.ext
</ProjectItem>

특성 및 요소

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

특성

특성	설명
`TargetFileName`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 프로젝트 항목의 이름과 경로를 지정합니다. 이 특성은 템플릿 .zip 파일의 디렉터리 구조와 다른 디렉터리 구조를 만들거나 매개 변수 대체를 사용하여 항목 이름을 만드는 데 유용합니다.
`ReplaceParameters`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 대체해야 하는 매개 변수 값이 항목에 있는지 여부를 지정하는 부울 값입니다. 기본값은 `false`여야 합니다.
`OpenInEditor`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 Visual Studio의 개별 편집기에서 항목을 열어야 하는지 여부를 지정하는 부울 값입니다. `OpenInEditor` 값이 `true`인 항목에서 `OpenInWebBrowser` 및 `OpenInHelpBrowser` 특성이 무시됩니다. 기본값은 `false`입니다.
`OpenInWebBrowser`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 웹 브라우저에서 항목을 열어야 하는지 여부를 지정하는 부울 값입니다. 프로젝트에 로컬인 HTML 파일 및 텍스트 파일만 웹 브라우저에서 열 수 있습니다. 이 특성으로 외부 URL을 열 수는 없습니다. 기본값은 `false`입니다.
`OpenInHelpBrowser`	선택적 특성입니다. 템플릿에서 프로젝트를 만들 때 도움말 뷰어에서 항목을 열어야 하는지 여부를 지정하는 부울 값입니다. 프로젝트에 로컬인 HTML 파일 및 텍스트 파일만 도움말 브라우저에서 열 수 있습니다. 이 특성으로 외부 URL을 열 수는 없습니다. 기본값은 `false`입니다.
`OpenOrder`	선택적 특성입니다. 항목이 개별 편집기에서 열리는 순서를 나타내는 숫자 값을 지정합니다. 모든 값은 10의 배수여야 합니다. 더 높은 `OpenOrder` 값을 가진 항목이 먼저 열립니다.

자식 요소

없음

부모 요소

요소	Description
프로젝트	프로젝트에 추가할 파일 또는 디렉터리를 지정합니다.

텍스트 값

텍스트 값은 필수입니다.

템플릿 .zip 파일의 파일 이름 또는 경로를 나타내는 string입니다.

설명

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

TargetFileName 특성을 사용하여 템플릿 .zip 파일의 디렉터리 구조와 다른 디렉터리 구조를 만들 수 있습니다. 예를 들어 MyFile.vb 파일이 템플릿 .zip 파일의 루트에 있지만 템플릿에서 만든 모든 프로젝트에서 CustomFiles라는 디렉터리에 파일을 배치하려는 경우 다음 XML을 사용합니다.

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

TargetFileName 특성은 파일 이름에 국가별 문자가 포함된 파일의 이름을 바꾸는 데 사용할 수도 있습니다. 예를 들어 템플릿 .zip 파일은 유니코드 문자가 있는 파일 이름을 포함할 수 없으므로 파일을 .zip 파일로 압축하려면 먼저 파일 이름을 바꿔야 합니다. TargetFileName 특성을 사용하여 파일 이름을 다시 원래 유니코드 파일 이름으로 설정할 수 있습니다.

TargetFileName 특성은 매개 변수를 사용하여 파일의 이름을 바꾸는 데도 사용할 수 있습니다. 다음 절차에서는 템플릿 .zip 파일의 루트 디렉터리에 있는 MyFile.vb 파일의 이름을 프로젝트 이름을 기반으로 한 파일 이름으로 바꾸는 방법을 설명합니다.

매개 변수를 사용하여 파일 이름을 바꾸려면

.vstemplate 파일에서 다음 XML을 사용합니다.

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

텍스트 편집기 또는 Visual Studio에서 프로젝트 파일(Visual Basic 프로젝트의 경우 .vbproj)을 엽니다.
프로젝트 파일에서 다음 XML과 유사한 줄을 찾습니다.
```
<Compile Include="MyFile.vb">
```
이 코드 줄을 다음 XML로 바꿉니다.
```
<Compile Include="$safeprojectname$.vb">
```
이 템플릿에서 프로젝트를 만들 때 파일 이름은 사용자가 새 프로젝트 대화 상자에 입력한 이름을 기반으로 하며 안전하지 않은 문자와 공백이 모두 제거됩니다. 자세한 내용은 템플릿 매개 변수를 참조하세요.

예시

다음 예제는 Visual C# 애플리케이션의 프로젝트 템플릿용 메타데이터를 보여 줍니다.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem ReplaceParameters="true">Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

다음을 통해 공유