Elemento ProjectItem (modelli di progetto di Visual Studio)

Articolo
10/10/2023

Specifica un file incluso nel modello di progetto.

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 i ProjectItem modelli di progetto. Per una spiegazione dell'elemento per i ProjectItem modelli di elemento, vedere Elemento ProjectItem (modelli di elementi di Visual Studio).

Sintassi

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        FileName.ext
</ProjectItem>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
`TargetFileName`	Attributo facoltativo. Specifica il nome e il percorso dell'elemento di progetto quando viene creato un progetto dal modello. Questo attributo è utile per la creazione di una struttura di directory diversa dalla struttura di directory nel file con estensione zip del modello o per l'uso della sostituzione dei parametri per creare un nome di elemento.
`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`.
`OpenInEditor`	Attributo facoltativo. Valore booleano che specifica se l'elemento deve essere aperto nel rispettivo editor in Visual Studio quando viene creato un progetto dal modello. Gli `OpenInWebBrowser` attributi e `OpenInHelpBrowser` vengono ignorati in un elemento con un `OpenInEditor` valore .`true` Il valore predefinito è `false`.
`OpenInWebBrowser`	Attributo facoltativo. Valore booleano che specifica se l'elemento deve essere aperto nel Web browser quando viene creato un progetto dal modello. Solo i file HTML e i file di testo locali del progetto possono essere aperti nel Web browser. Gli URL esterni non possono essere aperti con questo attributo. Il valore predefinito è `false`.
`OpenInHelpBrowser`	Attributo facoltativo. Valore booleano che specifica se l'elemento deve essere aperto nel visualizzatore della Guida quando viene creato un progetto dal modello. Solo i file HTML e i file di testo locali del progetto possono essere aperti nel browser della Guida. Gli URL esterni non possono essere aperti con questo attributo. Il valore predefinito è `false`.
`OpenOrder`	Attributo facoltativo. Specifica un valore numerico che rappresenta l'ordine di apertura degli elementi nei rispettivi editor. Tutti i valori devono essere multipli di 10. Gli elementi con valori più elevati `OpenOrder` vengono aperti per primi.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
Progetto	Specifica i file o le directory da aggiungere al progetto.

Valore di testo

È necessario specificare un valore di testo.

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

Osservazioni:

ProjectItem è un elemento figlio facoltativo di Project.

L'attributo TargetFileName può essere usato per creare una struttura di directory diversa dalla struttura di directory nel file con estensione zip del modello. Ad esempio, se il file MyFile.vb esiste nella radice del file con estensione zip del modello, ma si vuole che il file venga inserito in una directory denominata CustomFiles in tutti i progetti creati dal modello, si userà il codice XML seguente:

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

L'attributo TargetFileName può essere usato anche per rinominare i file che contengono caratteri internazionali nei rispettivi nomi file. Ad esempio, un file con estensione zip modello non può contenere nomi di file con caratteri Unicode, quindi il file deve essere rinominato prima che possa essere compresso in un file ZIP. L'attributo TargetFileName può essere usato per ripristinare il nome file sul nome file Unicode originale.

L'attributo TargetFileName può essere usato anche per rinominare i file con parametri. La procedura seguente illustra come rinominare il file MyFile.vb, presente nella directory radice del file con estensione zip del modello, in un nome di file basato sul nome del progetto.

Per rinominare i file con parametri

Usare il codice XML seguente nel file con estensione vstemplate :

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

Aprire il file di progetto (con estensione vbproj per un progetto Visual Basic) in un editor di testo o in Visual Studio.
Individuare la riga nel file di progetto simile al codice XML seguente:
```
<Compile Include="MyFile.vb">
```
Sostituire la riga di codice con il codice XML seguente:
```
<Compile Include="$safeprojectname$.vb">
```
Quando un progetto viene creato da questo modello, il nome file sarà basato sul nome immesso dall'utente nella finestra di dialogo Nuovo progetto , con tutti i caratteri non sicuri e gli spazi rimossi. Per altre informazioni, vedere Parametri del modello.

Esempio

L'esempio seguente mostra i metadati per un modello di progetto per un'applicazione Visual C#.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem ReplaceParameters="true">Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

Condividi tramite