Includere un file di dati in un'applicazione ClickOnce
A ogni applicazione ClickOnce installata viene assegnata una directory dati nel disco locale del computer di destinazione in cui l'applicazione può gestire i propri dati. I file di dati possono includere file di qualsiasi tipo: file di testo, file XML o anche file di database di Microsoft Access (con estensione mdb). Le procedure seguenti illustrano come aggiungere un file di dati di qualsiasi tipo nell'applicazione ClickOnce.
Nota
In ClickOnce per .NET Core 3.1 e .NET 5 o versione successiva usare dotnet-mage.exe anziché Mage.exe. Per altre informazioni, vedere ClickOnce per .NET.
Per includere un file di dati utilizzando Mage.exe
Aggiungere il file di dati alla directory dell'applicazione con il resto dei file dell'applicazione.
In genere, la directory dell'applicazione sarà una directory etichettata con la versione corrente della distribuzione, ad esempio v1.0.0.0.
Aggiornare il manifesto dell'applicazione per elencare il file di dati.
mage -u v1.0.0.0\Application.manifest -FromDirectory v1.0.0.0
L'esecuzione di questa attività ricrea l'elenco dei file nel manifesto dell'applicazione e genera automaticamente anche le firme hash.
Aprire il manifesto dell'applicazione nell'editor di testo o XML preferito e trovare l'elemento
file
per il file aggiunto di recente.Se è stato aggiunto un file XML denominato
Data.xml
, il file sarà simile all'esempio di codice seguente.<file name="Data.xml" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />
Aggiungere l'attributo
type
a questo elemento e specificarlo con il valoredata
.<file name="Data.xml" writeableType="applicationData" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />
Firmare nuovamente il manifesto dell'applicazione usando la coppia di chiavi o il certificato e quindi firmare nuovamente il manifesto della distribuzione.
È necessario firmare nuovamente il manifesto della distribuzione perché il relativo hash del manifesto dell'applicazione è stato modificato.
mage -s app manifest -cf cert_file -pwd password
mage -u deployment manifest -appm app manifest
mage -s deployment manifest -cf certfile -pwd password
Per includere un file di dati utilizzando MageUI.exe
Aggiungere il file di dati alla directory dell'applicazione con il resto dei file dell'applicazione.
In genere, la directory dell'applicazione sarà una directory etichettata con la versione corrente della distribuzione, ad esempio v1.0.0.0.
Scegliere Apri dal menu File per aprire il manifesto dell'applicazione.
Selezionare la scheda File .
Nella casella di testo nella parte superiore della scheda immettere la directory contenente i file dell'applicazione e quindi fare clic su Popola.
Il file di dati verrà visualizzato nella griglia.
Impostare il valore Tipo di file del file di dati su Dati.
Salvare il manifesto dell'applicazione e quindi firmare nuovamente il file.
MageUI.exe chiederà di firmare nuovamente il file.
Firmare nuovamente il manifesto della distribuzione
È necessario firmare nuovamente il manifesto della distribuzione perché il relativo hash del manifesto dell'applicazione è stato modificato.