Share via


Einschließen einer Datendatei in eine ClickOnce-Anwendung

Jeder ClickOnce-Anwendung, die Sie installieren, wird ein Datenverzeichnis auf dem lokalen Datenträger des Zielcomputers zugewiesen, in dem die Anwendung ihre eigenen Daten verwalten kann. Datendateien können Dateien eines beliebigen Typs enthalten: Textdateien, XML-Dateien oder sogar Microsoft Access-Datenbankdateien (MDB-Dateien). Die folgenden Verfahren zeigen, wie Sie Ihrer ClickOnce-Anwendung eine Datendatei eines beliebigen Typs hinzufügen.

Hinweis

Verwenden Sie in ClickOnce für .NET Core 3.1 und .NET 5 oder höher dotnet-mage.exe anstelle von Mage.exe. Weitere Informationen finden Sie unter ClickOnce für .NET.

So binden Sie eine Datendatei mithilfe von „Mage.exe“ ein

  1. Fügen Sie die Datendatei Ihrem Anwendungsverzeichnis mit den restlichen Dateien Ihrer Anwendung hinzu.

    In der Regel handelt es sich bei Ihrem Anwendungsverzeichnis um ein Verzeichnis mit der Bezeichnung der aktuellen Version der Bereitstellung, z. B. v1.0.0.0.

  2. Aktualisieren Sie Ihr Anwendungsmanifest, damit die Datendatei aufgelistet wird.

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

    Durch Ausführen dieser Aufgabe wird die Liste der Dateien in Ihrem Anwendungsmanifest neu erstellt, und auch die Hashsignaturen werden automatisch generiert.

  3. Öffnen Sie das Anwendungsmanifest in Ihrem bevorzugten Text- oder XML-Editor, und suchen Sie nach dem file-Element für Ihre kürzlich hinzugefügte Datei.

    Wenn Sie eine XML-Datei mit dem Namen Data.xml hinzugefügt haben, sieht die Datei in etwa wie das folgende Codebeispiel aus.

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

  4. Fügen Sie diesem Element das Attribut type hinzu, und weisen Sie ihm den Wert data zu.

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

  5. Signieren Sie Ihr Anwendungsmanifest erneut, indem Sie Ihr Schlüsselpaar oder Zertifikat verwenden, und signieren Sie dann Ihr Bereitstellungsmanifest erneut.

    Sie müssen Ihr Bereitstellungsmanifest erneut signieren, weil sich der Hash des Anwendungsmanifests geändert hat.

    mage -s app manifest -cf cert_file -pwd password

    mage -u deployment manifest -appm app manifest

    mage -s deployment manifest -cf certfile -pwd password

So binden Sie eine Datendatei mithilfe von „MageUI.exe“ ein

  1. Fügen Sie die Datendatei Ihrem Anwendungsverzeichnis mit den restlichen Dateien Ihrer Anwendung hinzu.

  2. In der Regel handelt es sich bei Ihrem Anwendungsverzeichnis um ein Verzeichnis mit der Bezeichnung der aktuellen Version der Bereitstellung, z. B. v1.0.0.0.

  3. Klicken Sie im Menü Datei auf Öffnen, um Ihr Anwendungsmanifest zu öffnen.

  4. Wählen Sie die Registerkarte Dateien aus.

  5. Geben Sie im Textfeld oben auf der Registerkarte das Verzeichnis ein, das die Dateien Ihrer Anwendung enthält, und klicken Sie dann auf Auffüllen.

    Ihre Datendatei wird im Raster angezeigt.

  6. Legen Sie den Wert Dateityp der Datendatei auf Daten fest.

  7. Speichern Sie das Anwendungsmanifest, und signieren Sie die Datei dann erneut.

    MageUI.exe fordert Sie auf, die Datei erneut zu signieren.

  8. Erneutes Signieren Ihres Bereitstellungsmanifests

    Sie müssen Ihr Bereitstellungsmanifest erneut signieren, weil sich der Hash des Anwendungsmanifests geändert hat.