Includere un file di dati in un'applicazione ClickOnce

  • Articolo

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

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

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

  3. 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" />

  4. Aggiungere l'attributo type a questo elemento e specificarlo con il valore data.

    <file name="Data.xml" writeableType="applicationData" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

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

  1. Aggiungere il file di dati alla directory dell'applicazione con il resto dei file dell'applicazione.

  2. In genere, la directory dell'applicazione sarà una directory etichettata con la versione corrente della distribuzione, ad esempio v1.0.0.0.

  3. Scegliere Apri dal menu File per aprire il manifesto dell'applicazione.

  4. Selezionare la scheda File .

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

  6. Impostare il valore Tipo di file del file di dati su Dati.

  7. Salvare il manifesto dell'applicazione e quindi firmare nuovamente il file.

    MageUI.exe chiederà di firmare nuovamente il file.

  8. Firmare nuovamente il manifesto della distribuzione

    È necessario firmare nuovamente il manifesto della distribuzione perché il relativo hash del manifesto dell'applicazione è stato modificato.

Contenuto correlato