Elemento ProjectItem (modelli di elemento di Visual Studio)
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>