Elemento ProjectItem (modelli di elemento di Visual Studio)

  • Articolo

Specifica un file incluso nel modello di elemento.

Nota

L'elemento ProjectItem accetta attributi diversi a seconda che il modello sia per un progetto o un elemento. In questo argomento viene illustrato l'elemento per l'elemento ProjectItem . Per una spiegazione dell'elemento per i ProjectItem modelli di progetto, vedere Elemento ProjectItem (modelli di progetto di Visual Studio).

<VsTemplate><TemplateContent><ProjectItem>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
SubType Attributo facoltativo.

Specifica il sottotipo di un elemento in un modello di elemento a più file. Questo valore viene usato per determinare l'editor che Visual Studio userà per aprire l'elemento.
CustomTool Attributo facoltativo.

Imposta CustomTool per l'elemento nel file di progetto.
ItemType Attributo facoltativo.

Imposta itemType per l'elemento nel file di progetto.
ReplaceParameters Attributo facoltativo.

Valore booleano che specifica se l'elemento ha valori di parametro che devono essere sostituiti quando viene creato un progetto dal modello. Il valore predefinito è false.
TargetFileName Attributo facoltativo.

Specifica il nome dell'elemento creato dal modello. Questo attributo è utile per l'uso della sostituzione dei parametri per creare un nome di elemento.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
TemplateContent Specifica il contenuto del modello.

Valore di testo

È necessario specificare un valore di testo.

Oggetto string che rappresenta il nome di un file nel file con estensione zip del modello.

Osservazioni:

ProjectItem è un elemento figlio facoltativo di TemplateContent.

L'attributo TargetFileName può essere usato per rinominare i file con parametri. Ad esempio, se il file MyFile.vb esiste nella directory radice del file con estensione zip del modello, ma si vuole che il file venga denominato in base al nome file fornito dall'utente nella finestra di dialogo Aggiungi nuovo elemento, si userà il codice XML seguente:

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

Quando viene creato un elemento da questo modello, il nome del file sarà basato sul nome immesso dall'utente nella finestra di dialogo Aggiungi nuovo elemento . Ciò è utile quando si creano modelli di elementi multi-file. Per altre informazioni, vedere Procedura: Creare modelli di elementi multi-file e parametri di modello.

Esempio

L'esempio seguente illustra i metadati per il modello di elemento standard per una classe Visual C#.

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

Vedi anche