Gewusst wie: Angeben der mit ClickOnce veröffentlichten Dateien
Beim Veröffentlichen einer ClickOnce-Anwendung werden alle Dateien im Projekt, die keine Codedateien sind, zusammen mit der Anwendung bereitgestellt. In einigen Fällen möchten oder müssen Sie bestimmte Dateien nicht veröffentlichen, oder Sie möchten bestimmte Dateien anhand von Bedingungen installieren. Mit Visual Studio können Dateien ausgeschlossen oder als erforderliche Komponenten bzw. Datendateien markiert werden. Außerdem lassen sich Dateigruppen für die bedingte Installation erstellen.
Dateien für eine ClickOnce-Anwendung werden im Projekt-Designer auf der Seite Veröffentlichen mithilfe des Dialogfelds Anwendungsdateien verwaltet.
Zunächst ist eine einzelne Dateigruppe mit dem Namen (Erforderlich) vorhanden. Sie können weitere Dateigruppen erstellen und ihnen Dateien zuweisen. Die Downloadgruppe kann nicht für für Dateien geändert werden, die für die Ausführung der Anwendung erforderlich sind. Zum Beispiel müssen die EXE-Datei der Anwendung oder als Datendateien markierte Dateien zu der Gruppe (Required) gehören.
Der Standardwert des Veröffentlichungsstatus einer Datei wird mit (Auto) markiert. Die EXE-Datei der Anwendung verfügt z. B. in der Standardeinstellung über den Veröffentlichungsstatus Einschließen (Auto).
Dateien, für die die Build Action-Eigenschaft auf Inhalt festgelegt ist, werden als Anwendungsdateien bezeichnet und standardmäßig als "Eingeschlossen" markiert. Sie können den Status "Eingeschlossen" oder "Ausgeschlossen" haben oder als Datendateien markiert sein. Dabei gelten folgende Ausnahmen:
Datendateien wie SQL Database (.mdf und .mdb)- und XML-Dateien werden standardmäßig als Datendateien markiert.
Verweise auf Assemblys (DLL-Dateien) werden beim Hinzufügen des Verweises wie folgt gekennzeichnet: Wenn Lokale Kopie auf False festgelegt ist, wird sie standardmäßig als erforderliche Assembly (Erforderliche Komponente (Auto)) markiert, die im GAC vorhanden sein muss, bevor die Anwendung installiert wird. Wenn Lokale Kopie auf True festgelegt ist, wird die Assembly standardmäßig als Anwendungsassembly (Einschließen (Auto)) markiert und bei der Installation in den Anwendungsordner kopiert. Ein COM-Verweis wird nur dann im Dialogfeld Anwendungsdateien (als OCX-Datei) angezeigt, wenn dessen Isolated-Eigenschaft auf True festgelegt ist. Standardmäßig ist er eingeschlossen.
So fügen Sie dem Dialogfeld "Anwendungsdateien" Dateien hinzu
Wählen Sie im Projektmappen-Explorer eine Datei aus.
Legen Sie im Eigenschaftenfenster die Eigenschaft Build Action auf den Wert Inhalt fest.
So schließen Sie Dateien von der ClickOnce-Veröffentlichung aus
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Veröffentlichen.
Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.
Wählen Sie im Dialogfeld Anwendungsdateien die Datei aus, die Sie ausschließen möchten.
Wählen Sie im Feld Veröffentlichungsstatus in der Dropdownliste die Option Ausschließen aus.
So markieren Sie Dateien als Datendateien
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Veröffentlichen.
Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.
Wählen Sie im Dialogfeld Anwendungsdateien die Datei aus, die Sie als Daten markieren möchten.
Wählen Sie im Feld Veröffentlichungsstatus in der Dropdownliste die Option Datendatei aus.
So markieren Sie Dateien als erforderliche Komponenten
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Veröffentlichen.
Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.
Wählen Sie im Dialogfeld Anwendungsdateien die Anwendungsassembly (DLL-Datei) aus, die Sie als erforderliche Komponente markieren möchten. Beachten Sie, dass Ihre Anwendung über einen Verweis auf die Anwendungsassembly verfügen muss, um in der Liste angezeigt zu werden.
Wählen Sie im Feld Veröffentlichungsstatus in der Dropdownliste die Option Erforderliche Komponente aus.
So fügen Sie eine neue Dateigruppe hinzu
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Veröffentlichen.
Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.
Wählen Sie im Dialogfeld Anwendungsdateien das Feld Gruppieren für die Datei aus, die Sie in die neue Gruppe aufnehmen möchten.
Tipp
Für Dateien muss die Build Action-Eigenschaft auf Inhalt festgelegt werden, bevor die Dateinamen im Dialogfeld Anwendungsdateien angezeigt werden.
Wählen Sie im Feld Downloadgruppe in der Dropdownliste die Option <Neu...> aus.
Geben Sie im Dialogfeld Neue Gruppe einen Namen für die Gruppe ein, und klicken Sie anschließend auf OK.
So fügen Sie einer Gruppe eine Datei hinzu
Wählen Sie im Projektmappen-Explorer ein Projekt aus, und klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Veröffentlichen.
Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.
Wählen Sie im Dialogfeld Anwendungsdateien das Feld Gruppieren für die Datei aus, die Sie in die neue Gruppe aufnehmen möchten.
Wählen Sie im Feld Downloadgruppe in der Dropdownliste eine Gruppe aus.
Tipp
Die Downloadgruppe kann nicht für für Dateien geändert werden, die für die Ausführung der Anwendung erforderlich sind.
Siehe auch
Aufgaben
Gewusst wie: Veröffentlichen einer ClickOnce-Anwendung mit dem Webpublishing-Assistenten