Dialogfeld "Anwendungsdateien"
In diesem Dialogfeld können Sie angeben, wie die Dateien im Projekt zur Veröffentlichung, Aktualisierung und zum dynamischen Download kategorisiert werden. Es enthält ein Raster der Projektdateien, die standardmäßig nicht ausgeschlossen sind bzw. die über eine Downloadgruppe verfügen.
Wählen Sie zum Aufrufen dieses Dialogfelds einen Projektknoten im Projektmappen-Explorer aus, und klicken Sie anschließend im Menü Projekt auf Eigenschaften. Sobald der Projekt-Designer angezeigt wird, klicken Sie auf die Registerkarte Veröffentlichen. Klicken Sie auf der Seite Veröffentlichen auf die Schaltfläche Anwendungsdateien.
Das Raster zeigt den Dateinamen, den Veröffentlichungsstatus, die Downloadgruppe und den Hash-Wert für die einzelnen Dateien an.
Durch den Veröffentlichungsstatus einer Datei wird festgelegt, wie die Datei beim Veröffentlichen, Aktualisieren und beim dynamischen Download behandelt wird. Die Bedeutung der einzelnen Optionen für den Veröffentlichungsstatus wird in der folgenden Tabelle beschrieben. In der Dropdownliste Veröffentlichungsstatus eines bestimmten Dateityps werden nur Optionen zum Veröffentlichungsstatus angezeigt, die für diesen Dateityp anwendbar sind.
Option Veröffentlichungsstatus |
Beschreibungen |
Dateitypen, für die diese Option gilt |
|---|---|---|
Datendatei |
Schließt die Datendatei in das Manifest ein und kopiert sie beim Ausführen des Veröffentlichungsbefehls an den Veröffentlichungsort. Jede Nicht-Assemblydatei, für die Buildvorgang auf Inhalt festgelegt ist, kann diesen Veröffentlichungsstatus besitzen. Dateien mit den Erweiterungen .mdf, .ldf und .xml werden standardmäßig auf Datendatei festgelegt. Dateien dieses Typs werden in das Datenverzeichnis installiert. Bei einem Update der Anwendung wird eine Datendatei möglicherweise von der Anwendung migriert. Sobald ein Anwendungsupdate verfügbar ist, werden die Informationen in dieser Datei auf die nächste Anwendungsversion migriert. |
Nicht-Assemblydateien |
Einschließen |
Schließt die Datei in das Manifest ein und kopiert sie beim Ausführen des Veröffentlichungsbefehls an den Veröffentlichungsort. Dateien dieses Typs werden im Programmdateiordner installiert, in dem sich die EXE-Dateien und Assemblys der Anwendung befinden. |
Alle Dateien |
Exclude |
Schließt die Datei aus dem Manifest aus und kopiert sie beim Ausführen des Veröffentlichungsbefehls nicht an den Veröffentlichungsort. |
Alle Dateien |
Vorbereitungsmaßnahme |
Schließt die Datei in das Manifest ein und kopiert sie beim Ausführen des Veröffentlichungsbefehls nicht an den Veröffentlichungsort. Die Installation wird blockiert, wenn diese Datei nicht bereits im GAC (globalen Assemblycache) vorhanden ist. Der Endbenutzer bestimmt die Installation der erforderlichen Komponenten. Nur signierte Assemblys mit starkem Namen sollten als erforderliche Komponenten markiert werden. |
Assemblydateien |
Für Datendateien überschreibt die Migration keine Benutzeränderungen auf dem Clientcomputer. Informationen zum Migrieren von Datenbankdateien finden Sie unter Zugreifen auf lokale und Remotedaten in einer ClickOnce-Anwendung.
Wenn Sie eine der Optionen (Auto)-Optionen unter Veröffentlichungsstatus auswählen, z. B. Einschließen (Auto), wird der Veröffentlichungsstatus der Datei automatisch auf der Grundlage der folgenden Regeln festgelegt:
PDB-Dateien werden standardmäßig ausgeschlossen.
MDF-, LDF-, MDB- und XML-Dateien werden standardmäßig auf Datendatei festgelegt.
Die <Assemblyname>.xml-Datei wird standardmäßig ausgeschlossen.
Alle anderen Inhaltsdateien, für die Buildvorgang auf Inhalt festgelegt ist, verfügen über den Standardwert Einschließen. Inhaltsdateien, für die Buildvorgang nicht auf Inhalt festgelegt ist, werden nicht im Dialogfeld Anwendungsdateien angezeigt und nicht veröffentlicht.
Einschließen und Ausschließen überschreiben die automatisch festgelegten (Auto)-Optionen.
Das Dialogfeld enthält die Spalte Hash mit der Option, Dateien vom erzeugten Hash ein- oder auszuschließen.
Tipp
Wenn Sie die Einstellung Hash einer Datei auf Ausschließen festlegen, wird eine Warnung im Datensatz der Datei im Raster angezeigt. Die Warnung "Ein Projekt mit nicht gehashten Verweisen kann nicht signiert werden" wird angezeigt, selbst wenn auf der Seite Signieren die Option ClickOnce-Manifeste signieren nicht ausgewählt ist. Wenn Sie beabsichtigen, die Anwendung zusammen mit nicht signierten Manifesten zu veröffentlichen, können Sie diese Warnung einfach ignorieren. Wenn die Anwendung zum Veröffentlichen mit signierten Manifesten konfiguriert ist, wird ein Buildfehler ausgelöst. Weitere Informationen finden Sie unter Gewusst wie: Signieren von Anwendungs- und Bereitstellungsmanifesten.