ProjectItem Element (szablony elementów Visual Studio)

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

[!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 elemencie.Wyjaśnienie ProjectItem element szablonów projektu, zobacz ProjectItem — Element (Szablony projektu Visual Studio).

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

Atrybuty i elementy

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

Atrybuty

Atrybut	Opis
SubType	Atrybut opcjonalny. Określa podtypu elementu w szablonie elementu funkcje.Ta wartość jest używana do określenia edytora, Visual Studio będzie używać do otwierania elementu.
CustomTool	Atrybut opcjonalny. Ustawia CustomTool dla elementu w pliku projektu.
ItemType	Atrybut opcjonalny. Ustawia ItemType dla elementu w pliku projektu.
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.
TargetFileName	Atrybut opcjonalny. Określa nazwę elementu, który jest tworzony na podstawie szablonu.Ten atrybut jest przydatne do tworzenia nazwy elementu za pomocą parametru zastępczego.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element	Opis
TemplateContent	Określa zawartość szablonu.

Wartość tekstowa

Wymagana jest wartość tekstu.

A string , reprezentuje nazwę pliku w pliku zip szablonu.

Uwagi

ProjectItemopcjonalne dziecko jest TemplateContent.

TargetFileName Atrybut może służyć do zmiany nazwy plików z parametrami.Na przykład jeśli plik MyFile.vb istnieje w katalogu głównym plik zip szablonu, ale chcesz plik o nazwie na podstawie nazwy pliku przez użytkownika w Dodaj nowy element okno dialogowe, należy użyć następujących XML:

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

Gdy towar zostanie utworzony na podstawie tego szablonu, nazwa pliku będzie opierać się na nazwie użytkownika wprowadzonej w Dodaj nowy element okno dialogowe.Jest to przydatne podczas tworzenia elementu funkcje szablony.Aby uzyskać więcej informacji, zobacz Jak: Tworzenie szablonów elementu wieloplikowych i Parametry szablonu.

Przykład

Poniższy przykład ilustruje metadane dla szablonu standardowego elementu dla Visual C# klasy.

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

Zobacz też

Zadania

Jak: Tworzenie szablonów elementu wieloplikowych

Informacje

Odwołanie do schematu szablonu Visual Studio

Koncepcje

Wprowadzenie do programu Visual Studio, szablony

Parametry szablonu