Specificare i file da pubblicare mediante ClickOnce
Quando si pubblica un'applicazione ClickOnce, tutti i file necessari nel progetto vengono distribuiti insieme all'applicazione. Il set predefinito di file obbligatori è determinato dal tipo di progetto (ad esempio, un'app Windows Form). In alcuni casi, potrebbe non essere necessario pubblicare determinati file o installare determinati file in base alle condizioni. Visual Studio offre le funzionalità per includere file, escludere file, contrassegnare i file come file di dati o prerequisiti e creare gruppi di file per l'installazione condizionale.
I file per un'applicazione ClickOnce vengono gestiti nella finestra di dialogo File applicazione, accessibile dalla pagina Pubblica di Progettazione progetti.
Inizialmente, è presente un singolo filegroup denominato (Obbligatorio). È possibile creare gruppi di file aggiuntivi e assegnarvi file. Non è possibile modificare il gruppo di download per i file necessari per l'esecuzione dell'applicazione. Ad esempio, il .exe o i file dell'applicazione contrassegnati come file di dati devono appartenere al gruppo (Obbligatorio).
Il valore di stato di pubblicazione predefinito di un file è contrassegnato con (Auto).The default publish status value of a file is tagged with (Auto). Ad esempio, il .exe dell'applicazione ha lo stato di pubblicazione Include (Auto) per impostazione predefinita.
I file con la proprietà Azione di compilazione impostata su Contenuto sono designati come file dell'applicazione e verranno contrassegnati come inclusi per impostazione predefinita. Possono essere inclusi, esclusi o contrassegnati come file di dati. Le eccezioni sono le seguenti:
I file di dati, ad esempio database SQL (.mdf e .mdb) e i file XML verranno contrassegnati come file di dati per impostazione predefinita.
I riferimenti agli assembly (file .dll ) vengono designati come segue quando si aggiunge il riferimento: se Copy Local è False, viene contrassegnato per impostazione predefinita come assembly prerequisito (Prerequisito (Auto)) che deve essere presente nella GAC prima dell'installazione dell'applicazione. Se Copy Local è True, l'assembly viene contrassegnato per impostazione predefinita come assembly dell'applicazione (Include (Auto)) e verrà copiato nella cartella dell'applicazione durante l'installazione. Un riferimento COM verrà visualizzato nella finestra di dialogo File applicazione (come file con estensione ocx ) solo se la relativa proprietà Isolated è impostata su True. Per impostazione predefinita, verrà incluso.
Per aggiungere file alla finestra di dialogo File applicazione
Selezionare un file di dati in Esplora soluzioni.
Nella Finestra Proprietà modificare la proprietà Azione di compilazione impostandola sul valore Contenuto.
Per escludere i file dalla pubblicazione ClickOnce
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Nota
In ClickOnce per .NET Core 3.1 e .NET 5 o versione successiva è possibile impostare le proprietà di distribuzione usando lo strumento Pubblica anziché la pubblicazione guidata e la pagina Pubblica di Progettazione progetti. Per altre informazioni, vedere Distribuire un'applicazione Windows .NET con ClickOnce e ClickOnce per .NET.
Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il file da escludere.
Nel campo Stato pubblicazione selezionare Escludi nell'elenco a discesa.
Per contrassegnare i file come file di dati
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il file da contrassegnare come dati.
Nel campo Stato pubblicazione selezionare File di dati dall'elenco a discesa.
Per contrassegnare i file come prerequisiti
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare l'assembly dell'applicazione (.dll file) da contrassegnare come prerequisito. Si noti che l'applicazione deve avere un riferimento all'assembly dell'applicazione affinché venga visualizzato nell'elenco.
Nel campo Stato pubblicazione selezionare Prerequisiti nell'elenco a discesa.
Per aggiungere un nuovo file group
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il campo Gruppo per un file che si desidera includere nel nuovo gruppo.
Nota
I file devono avere la proprietà Azione di compilazione impostata su Contenuto prima che i nomi dei file vengano visualizzati nella finestra di dialogo File applicazione.
Nel campo Gruppo di download selezionare <Nuovo...> dall'elenco a discesa.
Nella finestra di dialogo Nuovo gruppo immettere un nome per il gruppo e quindi fare clic su OK.
Per aggiungere un file a un gruppo
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il campo Gruppo per un file che si desidera includere nel nuovo gruppo.
Nel campo Download Group (Scarica gruppo) selezionare un gruppo dall'elenco a discesa.
Nota
Non è possibile modificare il gruppo di download per i file necessari per l'esecuzione dell'applicazione.