Inclure un fichier de données dans une application ClickOnce

  • Article

Un répertoire de données sur le disque local de l’ordinateur de destination est attribué à chaque application ClickOnce que vous installez. Elle peut y gérer ses propres données. Les fichiers de données peuvent inclure des fichiers de tout type : fichiers texte, fichiers XML ou même fichiers de base de données Microsoft Access (.mdb). Les procédures suivantes montrent comment ajouter un fichier de données de n’importe quel type dans votre application ClickOnce.

Note

Dans ClickOnce pour .NET Core 3.1 et .NET 5 (ou version ultérieure), utilisez dotnet-mage.exe au lieu de Mage.exe. Pour plus d’informations, consultez ClickOnce pour .NET.

Pour inclure un fichier de données à l’aide de Mage.exe

  1. Ajoutez le fichier de données à votre répertoire d’application avec les autres fichiers de votre application.

    En règle générale, votre répertoire d’application est un répertoire dont le nom contient la version actuelle du déploiement, par exemple v1.0.0.0.

  2. Mettez à jour votre manifeste d’application pour lister le fichier de données.

    mage -u v1.0.0.0\Application.manifest -FromDirectory v1.0.0.0

    Cette tâche recrée la liste des fichiers dans votre manifeste d’application et génère automatiquement les signatures de hachage.

  3. Ouvrez le manifeste de l’application dans l’éditeur de texte ou XML de votre choix et recherchez l’élément file correspondant au fichier récemment ajouté.

    Si vous avez ajouté un fichier XML nommé Data.xml, le fichier ressemblera à l’exemple de code suivant.

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

  4. Ajoutez l’attribut type à cet élément et attribuez-lui la valeur data.

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

  5. Signez à nouveau votre manifeste d’application en utilisant votre paire de clés ou votre certificat, puis signez à nouveau votre manifeste de déploiement.

    Vous devez signer à nouveau votre manifeste de déploiement, car son hachage du manifeste d’application a changé.

    mage -s app manifest -cf cert_file -pwd password

    mage -u deployment manifest -appm app manifest

    mage -s deployment manifest -cf certfile -pwd password

Pour inclure un fichier de données à l’aide de MageUI.exe

  1. Ajoutez le fichier de données à votre répertoire d’application avec les autres fichiers de votre application.

  2. En règle générale, votre répertoire d’application est un répertoire dont le nom contient la version actuelle du déploiement, par exemple v1.0.0.0.

  3. Dans le menu Fichier, cliquez sur Ouvrir pour ouvrir votre manifeste d’application.

  4. Sélectionnez l’onglet Fichiers.

  5. Dans la zone de texte située en haut de l’onglet, entrez le répertoire qui contient les fichiers de votre application, puis cliquez sur Remplir.

    Votre fichier de données s’affiche dans la grille.

  6. Définissez la valeur Type de fichier du fichier de données sur Données.

  7. Enregistrez le manifeste de l’application, puis signez à nouveau le fichier.

    MageUI.exe vous invite à signer à nouveau le fichier.

  8. Signer à nouveau votre manifeste de déploiement

    Vous devez signer à nouveau votre manifeste de déploiement, car son hachage du manifeste d’application a changé.

Contenu connexe