Project-Element (Visual Studio-Vorlagen)

Artikel
02/26/2013

Gibt die Dateien oder Verzeichnisse an, die dem Projekt hinzugefügt werden sollen.

<Project
    File="MyProject.proj"
    TargetFileName="MyTargetProject.proj"
    ReplaceParameters="true/false">
    IgnoreProjectParameter="$myCustomParameter$"
        ...
</Project>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut	Description
File	Erforderliches Attribut. Gibt den Namen der Projektdatei in der ZIP-Datei der Vorlage an.
ReplaceParameters	Optionales Attribut. Ein boolescher Wert, durch den angegeben wird, ob die Projektdatei über Parameterwerte verfügt, die beim Erstellen des Projekts von der Vorlage ersetzt werden müssen.Der Standardwert lautet false.
TargetFileName	Optionales Attribut. Gibt bei der Projekterstellung von der Vorlage den Namen der Projektdatei an.
IgnoreProjectParameter	Optionales Attribut. Gibt an, ob das Projekt zur aktuellen Projektmappe hinzugefügt werden soll.Wenn der Wert des benutzerdefinierten Parameters, "$myCustomParameter$" in der Parameterersatzdatei vorhanden ist, wird das Projekt erstellt, aber hinzugefügt nicht als Teil der aktuell geöffneten Projektmappe.

Untergeordnete Elemente

Element	Description
Ordner	Optionales Element. Gibt einen Ordner an, der dem Projekt hinzugefügt werden soll.
ProjectItem	Optionales Element. Gibt eine Datei an, die einem Projekt hinzugefügt werden soll.

Ordner

Optionales Element.

Gibt einen Ordner an, der dem Projekt hinzugefügt werden soll.

ProjectItem

Optionales Element.

Gibt eine Datei an, die einem Projekt hinzugefügt werden soll.

Übergeordnete Elemente

Element	Description
TemplateContent	Erforderliches Element.

Hinweise

Project ist ein optionales untergeordnetes Element von TemplateContent.

Das Project-Element wird zum Festlegen eines Projekts verwendet und ist daher nur in Projektvorlagen gültig.

Project-Elemente können über untergeordnete Folder-Elemente oder untergeordnete ProjectItem-Elemente, nicht aber über eine Mischung aus untergeordneten Folder-Elementen und untergeordneten ProjectItem-Elementen verfügen.

Visual Studio benennt die Projektdatei automatisch um und verwendet dabei den Namen, den der Benutzer im Dialogfeld Neues Projekt eingegeben hat.Verwenden Sie das TargetFileName-Attribut, wenn Sie einen alternativen Dateinamen für die mit der Vorlage erstellten Projektdateien eingeben möchten.

Beispiel

Im folgenden Beispiel werden die Metadaten für eine Projektvorlage einer Visual C#-Anwendung veranschaulicht.

<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>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>