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

Article
01/13/2024

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

Syntaxe

<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 de modèle.
`ReplaceParameters`	Attribut facultatif. Valeur booléenne qui spécifie si le fichier projet a des valeurs de paramètre qui 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 n’est 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 à un 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 est utilisé pour spécifier un projet, et par conséquent, n’est valide que dans les modèles de projet.

Projectles éléments Folder children peuvent avoir des éléments Enfants dossier ou ProjectItem enfants, mais pas un mélange d’éléments enfants et ProjectItem les deuxFolder.

Visual Studio renomme automatiquement le nom du fichier projet en fonction du nom entré par l’utilisateur dans la boîte de dialogue Nouveau projet . Utilisez l’attribut TargetFileName si vous souhaitez fournir un autre nom de fichier pour les fichiers projet créés avec le modèle.

Exemple

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

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

Partager via