Project-Element (Visual Studio-Vorlagen)

Artikel
04/10/2024

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden attribute-Elemente sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
`File`	Erforderliches Attribut. Gibt den Namen der Projektdatei in der Vorlage .zip Datei an.
`ReplaceParameters`	Optionales Attribut. Ein boolescher Wert, der angibt, ob die Projektdatei Parameterwerte enthält, die ersetzt werden müssen, wenn ein Projekt aus der Vorlage erstellt wird. Der Standardwert ist `false`.
`TargetFileName`	Optionales Attribut. Gibt den Namen der Projektdatei an, wenn ein Projekt aus der Vorlage erstellt wird.
`IgnoreProjectParameter`	Optionales Attribut. Gibt an, ob das Projekt der aktuellen Projektmappe hinzugefügt werden soll. Wenn der Wert des benutzerdefinierten Parameters "$myCustomParameter$" in der Parameterersetzungsdatei vorhanden ist, wird das Projekt erstellt, aber nicht als Teil der aktuell geöffneten Lösung hinzugefügt.

Untergeordnete Elemente

Element	Beschreibung
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	Beschreibung
Templatecontent	Erforderliches Element.

Hinweise

Project ist ein optionales untergeordnetes Element von TemplateContent.

Das Project Element wird verwendet, um ein Projekt anzugeben und ist daher nur in Projektvorlagen gültig.

ProjectElemente können untergeordnete Ordnerelemente oder untergeordnete ProjectItem-Elemente aufweisen, jedoch keine Mischung aus elementen mit beiden Folder und ProjectItem untergeordneten Elementen.

Visual Studio benennt den Projektdateinamen basierend auf dem vom Benutzer im Dialogfeld "Neues Projekt " eingegebenen Namen automatisch um. Verwenden Sie das TargetFileName Attribut, wenn Sie einen alternativen Dateinamen für Projektdateien bereitstellen möchten, die mit der Vorlage erstellt wurden.

Beispiel

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

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

Freigeben über