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