Element ProjectItem (szablony projektu Visual Studio)

Artykuł
02/27/2013

Określa plik, który znajduje się w szablonie projektu.

[!UWAGA]

ProjectItem Element przyjmuje atrybuty różnych w zależności od tego, czy szablon jest dla projektu lub elementu.W tym temacie wyjaśniono ProjectItem element szablonów projektu.Wyjaśnienie ProjectItem elementu element szablonów, zobacz Element ProjectItem (Visual Studio element szablonów).

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybut, elementy podrzędne i elementów nadrzędnych.

Atrybuty

Atrybut	Opis
TargetFileName	Atrybut opcjonalny. Określa nazwę i ścieżkę do elementu projektu, gdy projekt jest tworzony na podstawie szablonu.Ten atrybut jest przydatne do tworzenia struktury katalogów różni się od struktury katalogów w pliku zip szablonu lub Utwórz przy użyciu parametru zastąpienie nazwy elementu.
ReplaceParameters	Atrybut opcjonalny. Wartość logiczna określająca, czy element ma wartości parametrów, które muszą zostać zastąpione, gdy projekt jest tworzony na podstawie szablonu.Wartością domyślną jest false.
OpenInEditor	Atrybut opcjonalny. Wartość logiczna, która określa, czy element powinien być otwarty w swoich odpowiednich edytora w Visual Studio podczas tworzenia projektu z szablonu. OpenInWebBrowser i OpenInHelpBrowser atrybuty są ignorowane na element z OpenInEditor wartość true. Wartością domyślną jest false.
OpenInWebBrowser	Atrybut opcjonalny. Wartość logiczna określająca, czy element powinien być otwarty w przeglądarce sieci Web podczas tworzenia projektu z szablonu. Tylko pliki HTML i pliki tekstowe, które są lokalne do projektu można otworzyć w przeglądarce sieci Web.Nie można otworzyć zewnętrznych adresów URL za pomocą tego atrybutu. Wartością domyślną jest false.
OpenInHelpBrowser	Atrybut opcjonalny. Wartość logiczna określająca, czy element powinien być otwarty w Podglądzie pomocy, podczas tworzenia projektu z szablonu. Tylko pliki HTML i pliki tekstowe, które są lokalne do projektu można otworzyć w przeglądarce pomocy.Nie można otworzyć zewnętrznych adresów URL za pomocą tego atrybutu. Wartością domyślną jest false.
OpenOrder	Atrybut opcjonalny. Określa wartość numeryczną, która reprezentuje zamówienia, że elementy będą otwierane w ich odpowiednich edytory.Wszystkie wartości muszą być wielokrotności 10.Elementy o wyższej OpenOrder wartości są otwierane po raz pierwszy.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element	Opis
Projekt	Określa pliki lub katalogi, aby dodać do projektu.

Wartość tekstowa

Wymagana jest wartość tekstu.

A string , reprezentuje nazwę lub ścieżkę do pliku w pliku zip szablonu.

Uwagi

ProjectItemopcjonalne dziecko jest Project.

TargetFileName Atrybut może służyć do tworzenia struktury katalogów różni się od struktury katalogów w pliku zip szablonu.Na przykład jeśli plik MyFile.vb istnieje w katalogu głównym plik zip szablonu, ale plik ma być umieszczony w katalogu o nazwie CustomFiles we wszystkich projektach, utworzony na podstawie szablonu, należy użyć następujących XML:

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

TargetFileName Atrybut można również zmienić nazwy plików, które zawierają znaki międzynarodowe, w ich nazwy.Na przykład plik zip szablonu nie może zawierać nazwy plików ze znakami Unicode, więc plik muszą być zmienione, zanim mogą być skompresowane w pliku .zip.TargetFileName Atrybut może służyć, aby ustawić nazwę oryginalnego pliku Unicode.

TargetFileName Atrybut można również zmienić nazwy plików z parametrami.Poniższa procedura wyjaśnia, jak zmienić nazwę pliku MyFile.vb, który istnieje w katalogu głównym pliku zip szablonu, do nazwy pliku na podstawie nazwy projektu.

Aby zmienić nazwy plików z parametrami

Użyj następujących XML w pliku .vstemplate:

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

Otwórz plik projektu (.vbproj dla Visual Basic projektu) w edytorze tekstu lub Visual Studio.
Zlokalizuj wiersz w pliku projektu, która wygląda podobnie do następującej XML:
```
<Compile Include="MyFile.vb">
```
Zamień wiersz kodu XML następujący:
```
<Compile Include="$safeprojectname$.vb">
```
Podczas tworzenia projektu na podstawie tego szablonu, nazwa pliku będzie opierać się na nazwie użytkownika wprowadzonej w Nowy projekt okno dialogowe, wszystkie znaki niebezpieczne i usunięte spacje.Aby uzyskać więcej informacji, zobacz Parametry szablonu.

Przykład

W poniższym przykładzie pokazano metadane dla szablonu projektu dla Visual C# aplikacji.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="https://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>