ProjectItem, élément (modèles d’élément Visual Studio)ProjectItem element (Visual Studio item templates)

Spécifie un fichier qui est inclus dans le modèle d’élément.Specifies a file that is included in the item template.

Note

Le ProjectItem élément accepte des attributs différents selon que le modèle est pour un projet ou un élément.The ProjectItem element accepts different attributes depending on whether the template is for a project or an item. Cette rubrique explique les ProjectItem élément pour l’élément.This topic explains the ProjectItem element for item. Pour obtenir une explication de la ProjectItem , élément pour les modèles de projet, consultez ProjectItem, élément (modèles de projet Visual Studio).For an explanation of the ProjectItem element for project templates, see ProjectItem element (Visual Studio project templates).

<VSTemplate ><VSTemplate>
<TemplateContent ><TemplateContent>
<ProjectItem ><ProjectItem>

SyntaxeSyntax

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

Attributs et élémentsAttributes and elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attribute, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
SubType Attribut facultatif.Optional attribute.

Spécifie le sous-type d’un élément dans un modèle d’élément multifichier.Specifies the subtype of an item in a multi-file item template. Cette valeur est utilisée pour déterminer l’éditeur qui Visual StudioVisual Studio utilisera pour ouvrir l’élément.This value is used to determine the editor that Visual StudioVisual Studio will use to open the item.
CustomTool Attribut facultatif.Optional attribute.

Définit l’outil personnalisé pour l’élément dans le fichier projet.Sets the CustomTool for the item in the project file.
ItemType Attribut facultatif.Optional attribute.

Définit le ItemType pour l’élément dans le fichier projet.Sets the ItemType for the item in the project file.
ReplaceParameters Attribut facultatif.Optional attribute.

Valeur booléenne qui spécifie si l’élément a des valeurs de paramètre qui doivent être remplacés lorsqu’un projet est créé à partir du modèle.A Boolean value that specifies whether the item has parameter values that must be replaced when a project is created from the template. La valeur par défaut est false.Default value is false.
TargetFileName Attribut facultatif.Optional attribute.

Spécifie le nom de l’élément qui est créé à partir du modèle.Specifies the name of the item that is created from the template. Cet attribut est utile pour l’utilisation de remplacement de paramètres pour créer un nom d’élément.This attribute is useful for using parameter replacement to create an item name.

Éléments enfantsChild elements

Aucun.None.

Éléments parentsParent elements

ÉlémentElement DescriptionDescription
TemplateContentTemplateContent Spécifie le contenu du modèle.Specifies the contents of the template.

Valeur texteText value

Une valeur texte est requise.A text value is required.

Un string qui représente le nom d’un fichier dans le modèle .zip fichier.A string that represents the name of a file in the template .zip file.

NotesRemarks

ProjectItem est un enfant facultatif de TemplateContent.ProjectItem is an optional child of TemplateContent.

Le TargetFileName attribut peut être utilisé pour renommer des fichiers avec des paramètres.The TargetFileName attribute can be used to rename files with parameters. Par exemple, si le fichier MyFile.vb existe dans le répertoire racine du modèle .zip fichier, mais vous souhaitez que le fichier se nomme en fonction du nom de fichier fourni par l’utilisateur dans le ajouter un nouvel élément boîte de dialogue, vous utiliseriez le code XML suivant :For example, if the file MyFile.vb exists in the root directory of the template .zip file, but you want the file to be named based on the file name provided by the user in the Add New Item dialog box, you would use the following XML:

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

Lorsqu’un élément est créé à partir de ce modèle, le nom de fichier doit reposer sur le nom de l’utilisateur a entré dans le ajouter un nouvel élément boîte de dialogue.When an item is created from this template, the file name will be based on the name the user entered in the Add New Item dialog box. Cela est utile lors de la création de modèles d’élément multifichier.This is useful when creating multi-file item templates. Pour plus d’informations, consultez Comment : créer des modèles d’élément multifichier et paramètres de modèle.For more information, see How to: Create multi-file item templates and Template parameters.

ExempleExample

L’exemple suivant illustre les métadonnées pour le modèle d’élément standard pour une Visual C#Visual C# classe.The following example illustrates the metadata for the standard item template for a Visual C#Visual C# class.

<VSTemplate Type="Item" Version="3.0.0"  
    xmlns="http://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 aussiSee also

Référence de schéma de modèle Visual Studio Visual Studio template schema reference
Création de modèles de projet et d’élément Creating project and item templates
Comment : créer des modèles d’élément multifichier How to: Create multi-file item templates
Paramètres de modèleTemplate parameters