Folder-Element (Visual Studio-Projektvorlagen)

Artikel
08/10/2011

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

<Folder Name="Project Folder">
    <Folder> ... </Folder>
    <ProjectItem> ... </ProjectItem>
</Folder>

Attribute und Elemente

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

Attribute

Attribut	Beschreibungen
Name	Erforderliches Attribut. Der Name des Projektordners.
TargetFolderName	Optionales Attribut. Gibt den Namen des Ordners bei der Projekterstellung von der Vorlage an. Dieses Attribut ist nützlich bei der Verwendung der Parameterersetzung beim Erstellen eines Ordnernamens oder beim Benennen eines Ordners mit einer internationalen Zeichenfolge, die in der ZIP-Datei nicht direkt verwendet werden kann.

Name

Erforderliches Attribut.

Der Name des Projektordners.

TargetFolderName

Optionales Attribut.

Gibt den Namen des Ordners bei der Projekterstellung von der Vorlage an. Dieses Attribut ist nützlich bei der Verwendung der Parameterersetzung beim Erstellen eines Ordnernamens oder beim Benennen eines Ordners mit einer internationalen Zeichenfolge, die in der ZIP-Datei nicht direkt verwendet werden kann.

Untergeordnete Elemente

Element	Beschreibung
Folder	Gibt einen Ordner an, der dem Projekt hinzugefügt werden soll. Ein Folder-Element kann untergeordnete Folder-Elemente enthalten.
ProjectItem	Gibt eine Datei an, die dem Projekt hinzugefügt werden soll.

Übergeordnete Elemente

Element	Beschreibung
Project	Optionales untergeordnetes Element von TemplateContent.

Hinweise

Folder ist ein optionales untergeordnetes Element von Project.

Die folgenden Möglichkeiten stehen zur Auswahl, um Projektelemente in Ordnern in einer Vorlage zu organisieren:

Schließen Sie die Ordner in die ZIP-Datei der Vorlage ein, und fügen Sie sie dem Projekt in der VSTEMPLATE-Datei hinzu, indem Sie den Pfad zur Datei in den ProjectItem-Elementen angeben, ohne Folder-Elemente festzulegen. Dies ist die empfohlene Methode. Beispiel:

...

<ProjectItem>\Folder\item.cs</ProjectItem>

<ProjectItem>Form1.cs</ProjectItem>

...
Schließen Sie die Ordner in die ZIP-Datei der Vorlage ein, und fügen Sie sie dem Projekt in der VSTEMPLATE-Datei mit Folder-Elementen hinzu. Beispiel:

...

<Folder name="Folder">

<ProjectItem>item.cs</ProjectItem>

</Folder>

<ProjectItem>Form1.cs</ProjectItem>

...
Schließen Sie keine Ordner in die ZIP-Datei der Vorlage ein. Stattdessen fügen Sie Ordner über das TargetFileName-Attribut des ProjectItem-Elements hinzu. Beispiel:

...

<ProjectItem TargetFileName="\Folder\item.cs">item.cs</ProjectItem>

<ProjectItem>Form1.cs</ProjectItem>

...

Beispiel

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

<VSTemplate Type="Project" Version="2.0.0"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <Folder Name="Properties">
                <ProjectItem>AssemblyInfo.cs</ProjectItem>
                <ProjectItem>Resources.resx</ProjectItem>
                <ProjectItem>Resources.Designer.cs</ProjectItem>
                <ProjectItem>Settings.settings</ProjectItem>
                <ProjectItem>Settings.Designer.cs</ProjectItem>
            </Folder>
        </Project>
    </TemplateContent>
</VSTemplate>

Siehe auch

Referenz

Schemareferenz zu Visual Studio-Vorlagen

ProjectItem-Element (Visual Studio-Elementvorlagen)

Weitere Ressourcen

Visual Studio-Vorlagen

Freigeben über