Specificare i file da pubblicare mediante ClickOnce

  • Articolo

Quando si pubblica un'applicazione ClickOnce, tutti i file non di codice nel progetto vengono distribuiti insieme all'applicazione. In alcuni casi, potrebbe non essere necessario pubblicare determinati file o installare determinati file in base alle condizioni. Visual Studio offre le funzionalità per 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, i file con estensione exe o exe 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 file con estensione 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 file con estensione mdf e mdb, e i file XML verranno contrassegnati come file di dati per impostazione predefinita.

  • I riferimenti agli assembly (file con estensione 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

  1. Selezionare un file di dati in Esplora soluzioni.

  2. Nella Finestra Proprietà modificare la proprietà Azione di compilazione impostandola sul valore Contenuto.

Per escludere i file dalla pubblicazione ClickOnce

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. 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.

  3. Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.

  4. Nella finestra di dialogo File applicazione selezionare il file da escludere.

  5. Nel campo Stato pubblicazione selezionare Escludi nell'elenco a discesa.

Per contrassegnare i file come file di dati

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.

  4. Nella finestra di dialogo File applicazione selezionare il file da contrassegnare come dati.

  5. Nel campo Stato pubblicazione selezionare File di dati dall'elenco a discesa.

Per contrassegnare i file come prerequisiti

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.

  4. Nella finestra di dialogo File applicazione selezionare l'assembly dell'applicazione (file con estensione dll) da contrassegnare come prerequisito. Si noti che l'applicazione deve avere un riferimento all'assembly dell'applicazione affinché venga visualizzato nell'elenco.

  5. Nel campo Stato pubblicazione selezionare Prerequisiti nell'elenco a discesa.

Per aggiungere un nuovo file group

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.

  4. 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.

  5. Nel campo Gruppo di download selezionare <Nuovo...> dall'elenco a discesa.

  6. 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

  1. Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.

  2. Fare clic sulla scheda Pubblica.

  3. Fare clic sul pulsante File applicazione per aprire la finestra di dialogo File applicazione.

  4. Nella finestra di dialogo File applicazione selezionare il campo Gruppo per un file che si desidera includere nel nuovo gruppo.

  5. 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.

Contenuto correlato