Project, élément (modèles Visual Studio)

Article
03/04/2013

Spécifie les fichiers ou répertoires à ajouter au projet.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
File	Attribut requis. Spécifie le nom du fichier projet dans le fichier .zip du modèle.
ReplaceParameters	Attribut facultatif. Valeur booléenne qui spécifie si le fichier projet contient des paramètres dont les valeurs doivent être remplacées lorsqu'un projet est créé à partir du modèle.La valeur par défaut est false
TargetFileName	Attribut facultatif. Spécifie le nom du fichier projet lorsqu'un projet est créé à partir du modèle.
IgnoreProjectParameter	Attribut facultatif. Spécifie si le projet doit être ajouté à la solution actuelle.Si la valeur du paramètre personnalisé, « $myCustomParameter$ » existe dans le fichier de remplacement de paramètre, le projet est créé mais pas ajouté dans le cadre de la solution actuellement ouverte.

Éléments enfants

Élément	Description
Dossier	Élément facultatif. Spécifie un dossier à ajouter au projet.
ProjectItem	Élément facultatif. Spécifie un fichier à ajouter au projet.

Dossier

Élément facultatif.

Spécifie un dossier à ajouter au projet.

ProjectItem

Élément facultatif.

Spécifie un fichier à ajouter au projet.

Éléments parents

Élément	Description
TemplateContent	Élément requis.

Notes

Project est un élément enfant facultatif de TemplateContent.

L'élément Project sert à spécifier un projet ; par conséquent, il n'est valide que dans les modèles de projet.

Les éléments Project peuvent avoir des éléments enfants Folder ou ProjectItem, mais pas un mélange d'éléments enfants Folder et ProjectItem.

Visual Studio renomme automatiquement le nom du fichier projet sur la base du nom entré par l'utilisateur dans la boîte de dialogue Nouveau projet.Utilisez l'attribut TargetFileName si vous souhaitez attribuer un autre nom aux fichiers projet créés avec le modèle.

Exemple

L'exemple suivant affiche les métadonnées d'un modèle de projet pour une application Visual C#.

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