Procedura: specificare i file da pubblicare mediante ClickOnce
Quando viene pubblicata un'applicazione ClickOnce, tutti i file non di codice presenti nel progetto vengono distribuiti insieme all'applicazione. In alcuni casi, può essere necessario che alcuni file non vengano pubblicati o che vengano installati in base a determinate condizioni. In Visual Studio è possibile escludere file, contrassegnarli come file di dati o prerequisiti, nonché creare gruppi di file per l'installazione condizionale.
I file di un'applicazione ClickOnce vengono gestiti nella finestra di dialogo File applicazione, accessibile dalla scheda Pubblica di Progettazione progetti.
Inizialmente esiste un unico gruppo di file denominato (Obbligatorio). È possibile creare altri gruppi di file e assegnare dei file a tali gruppi. Non è possibile modificare l'impostazione di Gruppo di download per i file necessari per l'esecuzione dell'applicazione. Ad esempio, il file eseguibile dell'applicazione o i file contrassegnati come file di dati devono appartenere al gruppo (Obbligatorio).
Il valore di stato di pubblicazione predefinito di un file include al dicitura (automatico). Ad esempio, il file eseguibile dell'applicazione presenta lo stato di pubblicazione Includi (automatico) per impostazione predefinita.
I file la cui proprietà Operazione di compilazione è impostata su Contenuto sono designati come file dell'applicazione e vengono contrassegnati come inclusi per impostazione predefinita. Tali file possono essere inclusi, esclusi o contrassegnati come file di dati. Le eccezioni sono le seguenti:
I file di dati, quali i file Database SQL (mdf e mdb) e i file XML, saranno contrassegnati come file di dati per impostazione predefinita.
I riferimenti agli assembly (file dll) vengono designati come illustrato di seguito, quando si aggiunge il riferimento. Se la proprietà Copia localmente è impostata su Falso, l'assembly viene contrassegnato per impostazione predefinita come assembly richiesto (Prerequisito (automatico)) che deve essere presente in GAC prima che l'applicazione sia installata. Se la proprietà Copia localmente è impostata su Vero, l'assembly è contrassegnato per impostazione predefinita come assembly dell'applicazione (Includi (automatico)) e verrà copiato nella cartella dell'applicazione al momento dell'installazione. Un riferimento COM sarà visualizzato (come file ocx) nella finestra di dialogo File applicazione solo se la proprietà Isolato è impostata su True e sarà incluso per impostazione predefinita.
Per aggiungere file alla finestra di dialogo File applicazione
Selezionare un file di dati in Esplora soluzioni.
Nella finestra Proprietà impostare la proprietà Build Action sul valore Content.
Per escludere i file dalla pubblicazione ClickOnce
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Scegliere il 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 dall'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.
Scegliere il pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il file da contrassegnare come file di 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.
Scegliere il pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare l'assembly dell'applicazione (file DLL) da contrassegnare come prerequisito. Si tenga presente che l'applicazione deve includere un riferimento all'assembly di applicazione affinché questo sia presente nell'elenco.
Nel campo Stato pubblicazione selezionare Prerequisito dall'elenco a discesa.
Per aggiungere un nuovo gruppo di file
Con un progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Pubblica.
Scegliere il pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il campo Gruppo relativo a un file che si desidera includere nel nuovo gruppo.
Nota
Affinché i nomi di file vengano visualizzati nella finestra di dialogo File applicazione, è necessario che la proprietà dei file Operazione di compilazione sia impostata su Contenuto.
Nel campo Gruppo di download selezionare <Nuovo...> nell'elenco a discesa.
Nella finestra di dialogo Nuovo gruppo immettere un nome per il gruppo, quindi scegliere 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.
Scegliere il pulsante File applicazione per aprire la finestra di dialogo File applicazione.
Nella finestra di dialogo File applicazione selezionare il campo Gruppo relativo a un file che si desidera includere nel nuovo gruppo.
Nel campo Gruppo di download selezionare un gruppo dall'elenco a discesa.
Nota
Non è possibile modificare l'impostazione di Gruppo di download per i file necessari per l'esecuzione dell'applicazione.
Vedere anche
Attività
Procedura: pubblicare un'applicazione ClickOnce mediante la Pubblicazione guidata