Procedura: integrare strumenti personalizzati nelle proprietà del progetto

È possibile aggiungere opzioni personalizzate dello strumento alla finestra Pagine delle proprietà di Visual Studio creando un file XML.

Nella sezione Proprietà di configurazione della finestra Pagine delle proprietà vengono visualizzati i gruppi di impostazioni noti come regole. Ogni regola contiene le impostazioni per uno strumento o un gruppo di funzionalità. La regola Linker, ad esempio, contiene le impostazioni per lo strumento linker. Le impostazioni in una regola possono essere suddivise in categorie.

È possibile creare un file di regole contenente le proprietà per lo strumento personalizzato in modo che le proprietà vengano caricate all'avvio di Visual Studio. Per informazioni su come modificare il file, vedere Platform Extensibility Part 2 nel blog del team di progetto di Visual Studio.

La cartella in cui inserire il file della regola dipende dalle impostazioni locali e dalla versione di Visual Studio in uso. In un prompt dei comandi per sviluppatori di Visual Studio 2019 o versione successiva, la cartella rules è %VSINSTALLDIR%MSBuild\Microsoft\VC\<version>\<locale>\, dove il <version> valore si trova v160 in Visual Studio 2019. <locale> è un LCID, ad esempio, 1033 per l'inglese. In Visual Studio 2017 la cartella rules è %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\. In un prompt dei comandi di Visual Studio 2015 o versioni precedenti, la cartella rules è %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\. Si userà un percorso diverso per ogni edizione di Visual Studio installata e per ogni lingua. Ad esempio, il percorso predefinito della cartella delle regole per Visual Studio 2019 Community Edition in inglese potrebbe essere C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\VC\v160\1033\.

Per aggiungere o modificare proprietà del progetto

1. Nell'editor XML, creare un file XML.

2. Salvare il file nella cartella delle regole predefinite. Modificare il percorso per la lingua e l'edizione di Visual Studio in uso. Ogni regola nella finestra Pagine delle proprietà è rappresentata da un file XML in questa cartella. Assicurarsi che il nome del file sia univoco all'interno della cartella.

3. Copiare il contenuto di un file di regole esistente, ad esempio rc.xml, chiuderlo senza salvare le modifiche e quindi incollare il contenuto nel nuovo file XML. È possibile copiare qualsiasi file di XML Schema da usare come modello. Scegliere uno simile allo strumento.

4. Nel nuovo file XML modificare il contenuto in base alle esigenze. Assicurarsi di modificare il nome della regola e Rule. DisplayName nella parte superiore del file.

5. Salvare le modifiche e chiudere il file.

6. I file XML nella cartella rules vengono caricati all'avvio di Visual Studio. Per testare il nuovo file, riavviare Visual Studio.

7. In Esplora soluzioni fare clic con il pulsante destro del mouse su un progetto e scegliere Proprietà. Nella finestra Pagine delle proprietà verificare che sia presente un nuovo nodo con il nome della regola.

Vedi anche

MSBuild dalla riga di comando - C++