Freigeben über


Angeben der mit ClickOnce veröffentlichten Dateien

Beim Veröffentlichen einer ClickOnce-Anwendung werden alle Nicht-Codedateien im Projekt zusammen mit der Anwendung bereitgestellt. Der Standardsatz der erforderlichen Dateien wird durch den Projekttyp (z. B. eine Windows Forms-App) bestimmt. In einigen Fällen möchten oder müssen Sie bestimmte Dateien möglicherweise nicht veröffentlichen, oder Sie möchten bestimmte Dateien basierend auf Bedingungen installieren. Visual Studio bietet Funktionen zum Einschließen und Ausschließen von Dateien, Kennzeichnen von Dateien als Datendateien oder erforderliche Komponenten und Erstellen von Dateigruppen zur bedingten Installation.

Dateien für eine ClickOnce-Anwendung werden im Dialogfeld Anwendungsdateien verwaltet, auf das über die Seite Veröffentlichen des Projekt-Designers zugegriffen werden kann.

Zunächst gibt es eine einzelne Dateigruppe mit dem Namen (Required) (Erforderlich). Sie können zusätzliche Dateigruppen erstellen und ihnen Dateien zuweisen. Sie können die Downloadgruppe für Dateien nicht ändern, die für die Ausführung der Anwendung erforderlich sind. Beispielsweise müssen die EXE-Datei oder als Datendateien markierten Dateien der Anwendung zur Gruppe Erforderlich gehören.

Der Standardwert für den Veröffentlichungsstatus einer Datei ist mit (Auto) (Automatisch) gekennzeichnet. Beispielsweise weist die EXE-Datei der Anwendung standardmäßig den Veröffentlichungsstatus Einschließen (automatisch) auf.

Dateien, deren Build Action-Eigenschaft (Buildaktion) auf Content (Inhalt) festgelegt ist, werden als Anwendungsdateien festgelegt und standardmäßig als eingeschlossen markiert. Sie können eingeschlossen, ausgeschlossen oder als Datendateien markiert werden. Folgende Ausnahmen gelten:

  • Datendateien wie SQL-Datenbank-Dateien (MDF- und MDB-Dateien) und XML-Dateien werden standardmäßig als Datendateien markiert.

  • Verweise auf Assemblys (DLL-Dateien) werden wie folgt festgelegt, wenn Sie den Verweis hinzufügen: Wenn der Wert Copy Local FALSE ist, wird sie standardmäßig als erforderliche Assembly (Prerequisite (Auto) (Voraussetzung (auto)) markiert, die im GAC vorhanden sein muss, bevor die Anwendung installiert wird. Wenn Copy LocalTRUE ist, wird die Assembly standardmäßig als Anwendungsassembly (Include (Auto)) gekennzeichnet und bei der Installation in den Anwendungsordner kopiert. Ein COM-Verweis wird im Dialogfeld Anwendungsdateien (als OCX-Datei) nur angezeigt, wenn die Isolated-Eigenschaft auf TRUE festgelegt ist. Standardmäßig wird sie eingeschlossen.

So fügen Sie dem Dialogfeld „Anwendungsdateien“ Dateien hinzu

  1. Wählen Sie im Projektmappen-Explorer eine Datendatei aus.

  2. Ändern Sie im Eigenschaftenfenster die Build Action-Eigenschaft in den Wert Content.

So schließen Sie Dateien von der ClickOnce-Veröffentlichung aus

  1. Klicken Sie bei ausgewähltem Projekt im Projektmappen-Explorerim Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Veröffentlichen.

    Hinweis

    In ClickOnce for .NET Core 3.1 und .NET 5 oder höher legen Sie Bereitstellungseigenschaften mithilfe des Veröffentlichungstools anstelle des Veröffentlichungs-Assistenten und der Seite „Veröffentlichen“ des Projekt-Designers fest. Weitere Informationen finden Sie unter Bereitstellen einer .NET-Windows-Anwendung mithilfe von ClickOnce und ClickOnce für .NET.

  3. Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.

  4. Wählen Sie im Dialogfeld Anwendungsdateien die Datei aus, die Sie ausschließen möchten.

  5. Wählen Sie im Feld Veröffentlichungsstatus die Option Ausschließen aus der Dropdownliste aus.

So markieren Sie Dateien als Datendateien

  1. Klicken Sie bei ausgewähltem Projekt im Projektmappen-Explorerim Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Veröffentlichen.

  3. Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.

  4. Wählen Sie im Dialogfeld Anwendungsdateien die Datei aus, die Sie als Daten markieren möchten.

  5. Wählen Sie im Feld Veröffentlichungsstatus die Option Datendatei aus der Dropdownliste aus.

So markieren Sie Dateien als Voraussetzungen

  1. Klicken Sie bei ausgewähltem Projekt im Projektmappen-Explorerim Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Veröffentlichen.

  3. Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.

  4. Wählen Sie im Dialogfeld Anwendungsdateien die Anwendungsassembly (DLL-Datei) aus, die Sie als Voraussetzung markieren möchten. Beachten Sie, dass Ihre Anwendung einen Verweis auf die Anwendungsassembly aufweisen muss, damit sie in der Liste angezeigt wird.

  5. Wählen Sie im Feld Veröffentlichungsstatus die Option Voraussetzung aus der Dropdownliste aus.

So fügen Sie eine neue Dateigruppe hinzu

  1. Klicken Sie bei ausgewähltem Projekt im Projektmappen-Explorerim Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Veröffentlichen.

  3. Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.

  4. Wählen Sie im Dialogfeld Anwendungsdateien das Feld Gruppe für eine Datei aus, die Sie in die neue Gruppe einschließen möchten.

    Hinweis

    Für Dateien muss die Build Action-Eigenschaft auf Content (Inhalt) festgelegt sein, bevor die Dateinamen im Dialogfeld Anwendungsdateien angezeigt werden.

  5. Wählen Sie im Feld Gruppe herunterladen die Option <Neu...> aus der Dropdownliste aus.

  6. Geben Sie im Dialogfeld Neue Gruppe einen Namen für die Gruppe ein, und klicken Sie dann auf OK.

So fügen Sie einer Gruppe eine Datei hinzu

  1. Klicken Sie bei ausgewähltem Projekt im Projektmappen-Explorerim Menü Projekt auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte Veröffentlichen.

  3. Klicken Sie auf die Schaltfläche Anwendungsdateien, um das Dialogfeld Anwendungsdateien zu öffnen.

  4. Wählen Sie im Dialogfeld Anwendungsdateien das Feld Gruppe für eine Datei aus, die Sie in die neue Gruppe einschließen möchten.

  5. Wählen Sie im Feld Gruppe herunterladen eine Gruppe aus der Dropdownliste aus.

    Hinweis

    Sie können die Downloadgruppe für Dateien nicht ändern, die für die Ausführung der Anwendung erforderlich sind.