Elemento ProjectItem (modelli di elementi di Visual Studio)

Aggiornamento: novembre 2007

Specifica un file che è incluso nel modello di elemento.

Nota:
L'elemento ProjectItem accetta diversi attributi in base al modello, se per un progetto o per un elemento. In questo argomento viene spiegato l'elemento ProjectItem per gli elementi. Per una spiegazione dell'elemento ProjectItem per i modelli di progetto, vedere Elemento ProjectItem (modelli di progetto Visual Studio).

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

Attributi ed elementi

Nelle seguenti sezioni sono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
SubType	Attributo facoltativo. Specifica il sottotipo di un elemento in un modello di elemento a più file. Questo valore serve per determinare l'editor che verrà utilizzato in Visual Studio per aprire l'elemento.
ReplaceParamenters	Attributo facoltativo. Un valore booleano che specifica se nell'elemento i valori dei parametri dovranno essere sostituiti quando viene creato un progetto dal modello. Il valore predefinito è false.
TargetFileName	Attributo facoltativo. Specifica il nome dell'elemento che viene creato dal modello. Questo attributo è utile per utilizzare la sostituzione dei parametri per la creazione di un nome di elemento.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
TemplateContent	Specifica il contenuto del modello.

Valore di testo

È necessario specificare un valore per il testo.

Una string che rappresenta il nome di un file nel file .zip del modello.

Note

ProjectItem è un elemento figlio facoltativo di TemplateContent.

L'attributo TargetFileName può essere utilizzato per rinominare i file con parametri. Ad esempio, se nella directory principale del file .zip del modello è presente il file MyFile.vb, ma si desidera assegnare al file un nome basato sul nome di file specificato dall'utente nella finestra di dialogo Aggiungi nuovo elemento, si dovrà utilizzare il seguente codice XML:

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

Quando da questo modello viene creato un elemento, il nome del file sarà basato sul nome specificato dall'utente nella finestra di dialogo Aggiungi nuovo elemento. Ciò è utile quando si creano modelli di elemento a più file. Per ulteriori informazioni, vedere Procedura: creare modelli di elementi a più file e Parametri di template.

Esempio

Nell'esempio riportato di seguito vengono illustrati i metadati per il modello di elemento standard per una classe di 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>

Vedere anche

Attività

Procedura: creare modelli di elementi a più file

Concetti

Parametri di template

Riferimenti

Riferimenti allo schema dei modelli di Visual Studio

Altre risorse

Modelli di Visual Studio