ProjectItem, élément (modèles d'élément Visual Studio)

Spécifie un fichier inclus dans le modèle d'élément.

Notes

L'élément ProjectItem accepte des attributs différents selon que le modèle concerne un projet ou un élément. Cette rubrique explique l'élément ProjectItem. Pour une explication de l'élément ProjectItem dans le cas de modèles de modèles de projet, consultez ProjectItem, élément (modèles de projet Visual Studio).

<ProjectItem
    SubType="Form/Component/CustomControl/UserControl"
    CustomTool="string"
    ItemType="string"
    ReplaceParameters="true/false"
    TargetFileName="TargetFileName.ext">
        FileName.ext
</ProjectItem>

Attributs et éléments

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

Attributs

Attribut	Description
SubType	Attribut facultatif. Spécifie le sous-type d'un élément dans un modèle à plusieurs fichiers. Cette valeur détermine l'éditeur qu'utilisera Visual Studio pour ouvrir l'élément.
CustomTool	Attribut facultatif. Définit le CustomTool pour l'élément dans le fichier projet.
ItemType	Attribut facultatif. Définit le ItemType pour l'élément dans le fichier projet.
ReplaceParameters	Attribut facultatif. Valeur booléenne qui spécifie si l'élément 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 de l'élément créé à partir du modèle. Cet attribut permet d'utiliser le remplacement de paramètre pour créer un nom d'élément.

Éléments enfants

Aucun

Éléments parents

Élément	Description
TemplateContent	Spécifie le contenu du modèle.

Valeur texte

Une valeur texte est requise.

string qui représente le nom d'un fichier dans le fichier .zip du modèle.

Notes

ProjectItem est un enfant facultatif de TemplateContent.

L'attribut TargetFileName permet de renommer des fichiers à l'aide de paramètres. Par exemple, si le fichier MyFile.vb existe dans le répertoire racine du fichier .zip du modèle et si vous souhaitez lui attribuer un nom basé sur celui que contient la boîte de dialogue Ajouter un nouvel élément, utilisez le XML suivant :

<ProjectItem TargetFileName="$fileinputname$.vb">MyFile.vb</ProjectItem>

Si vous créez un élément selon ce modèle, le nom du fichier correspond au nom entré dans la boîte de dialogue Ajouter un nouvel élément. Cela s'avère utile lors de la création de modèles d'élément à plusieurs fichiers. Pour plus d'informations, consultez Comment : créer des modèles d'élément multifichier et Paramètres de modèle.

Exemple

L'exemple suivant illustre les métadonnées d'un modèle d'élément standard pour une classe Visual C#.

<VSTemplate Type="Item" Version="2.0.0"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <DefaultName>MyClass.cs</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem ReplaceParameters="true">MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>

Voir aussi

Tâches

Comment : créer des modèles d'élément multifichier

Référence

Référence du schéma de modèle Visual Studio

Concepts

Paramètres de modèle

Autres ressources

Modèles Visual Studio