Partager via

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

  • Article

Mise à jour : novembre 2007

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

Remarque :

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

ReplaceParamenters

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

Concepts

Paramètres de modèle

Référence

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

Autres ressources

Modèles Visual Studio