Festlegen von ClickOnce-Veröffentlichungseigenschaften

  • Artikel

Sie können ClickOnce-Webpublishing-Eigenschaften auf der Seite Veröffentlichen des Project Designers oder mithilfe des Webpublishing-Assistenten konfigurieren. In diesem Artikel erfahren Sie, wie Sie grundlegende Eigenschaften wie den Veröffentlichungsort, die Installations-URL, den Online- oder Offlineinstallationsmodus und die Veröffentlichungsversion angeben.

Einen Veröffentlichungsort festlegen

Beim Veröffentlichen einer Anwendung mithilfe von ClickOnce, gibt die Eigenschaft Publish Location den Speicherort an, unter dem die Anwendungsdateien und das Anwendungsmanifest abgelegt werden. Dabei kann es sich um einen Dateipfad oder den Pfad zu einem FTP-Server handeln.

Sie können die Eigenschaft Publish Location auf der Seite Veröffentlichen des Projekt-Designers oder mit dem Webpublishing-Assistenten festlegen. Weitere Informationen finden Sie unter Vorgehensweise: Veröffentlichen einer ClickOnce-Anwendung mit dem Veröffentlichungs-Assistenten.

Hinweis

Wenn Sie mit ClickOnce mehrere Versionen einer Anwendung installieren, verschiebt die Installation ältere Versionen der Anwendung in einen Ordner mit dem Namen Archiv in dem von Ihnen angegebenen Veröffentlichungsort. Durch dieses Archivieren älterer Versionen wird sichergestellt, dass im Installationsverzeichnis keine Ordner älterer Versionen verbleiben.

  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. Geben Sie in das Feld Ort der Veröffentlichung den Ort für die Veröffentlichung in einem der folgenden Formate ein:

    • Geben Sie den Pfad zum Veröffentlichen in einer Dateifreigabe oder unter einem Datenträgerpfad als UNC-Pfad (\\Server\ApplicationName) oder Dateipfad (C:\Deploy\ApplicationName) ein.

    • Bei Veröffentlichung auf einem FTP-Server geben Sie den Pfad im Format „ftp://ftp.microsoft.com/<ApplicationName>“ ein.

      Beachten Sie, dass im Feld Ort der Veröffentlichung Text angegeben sein muss, damit die Schaltfläche zum Durchsuchen (...) funktioniert.

Angeben des Speicherorts für die Installation durch Endbenutzer

Beim Veröffentlichen einer ClickOnce-Anwendung ist der Speicherort, von dem Benutzer die Anwendung herunterladen und installieren, nicht unbedingt der Speicherort, an dem Sie die Anwendung ursprünglich veröffentlichen. In einigen Organisationen kann ein Entwickler eine Anwendung beispielsweise auf einem Stagingserver veröffentlichen, und dann würde ein Administrator die Anwendung auf einen Webserver verschieben.

In diesem Fall können Sie die Installation URL-Eigenschaft verwenden, um den Webserver anzugeben, von dem Benutzer die Anwendung herunterladen können. Dies ist erforderlich, damit das Anwendungsmanifest weiß, wo nach Updates gesucht werden soll.

Die Installation URL-Eigenschaft kann auf der Seite Veröffentlichen des Projekt-Designers festgelegt werden.

Hinweis

Die Installation URL-Eigenschaft kann auch mithilfe des PublishWizard festgelegt werden. Weitere Informationen finden Sie unter Vorgehensweise: Veröffentlichen einer ClickOnce-Anwendung mit dem Veröffentlichungs-Assistenten.

Eine Installations-URL festlegen

  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. Geben Sie im Feld „Installations-URL“ den Installationsspeicherort mit einer vollqualifizierten URL im Format https://www.contoso.com/ApplicationName oder einem UNC-Pfad im Format \Server\ApplicationName ein.

Angeben des Offline- oder Onlineinstallationsmodus von ClickOnce

Der Install Mode für eine ClickOnce-Anwendung bestimmt, ob die Anwendung offline oder online verfügbar ist. Wenn Sie Die Anwendung ist nur online verfügbar auswählen, müssen Benutzer*innen Zugriff auf die ClickOnce-Veröffentlichungsort haben (entweder eine Webseite oder eine Dateifreigabe), um die Anwendung ausführen zu können. Wenn Sie Die Anwendung ist auch offline verfügbar auswählen, fügt die Anwendung Einträge zum Startmenü sowie zum Dialogfeld Programme hinzufügen oder entfernen hinzu. Benutzer*innen können die Anwendung ausführen, wenn sie nicht verbunden sind.

Der Install Mode kann auf der Seite Veröffentlichen des Projekt-Designers festgelegt werden.

Hinweis

Der Install Mode kann auch mithilfe des Veröffentlichungs-Assistenten festgelegt werden. Weitere Informationen finden Sie unter Vorgehensweise: Veröffentlichen einer ClickOnce-Anwendung mit dem Veröffentlichungs-Assistenten.

Eine ClickOnce-Anwendung nur online verfügbar machen

  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 im Bereich Installationsmodus und -einstellungen auf die Optionsschaltfläche Die Anwendung ist nur online verfügbar.

Eine ClickOnce-Anwendung online oder offline verfügbar machen

  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 im Bereich Installationsmodus und -einstellungen auf die Optionsschaltfläche Die Anwendung ist auch offline verfügbar.

    Nach der Installation fügt die Anwendung Einträge zum Startmenü und zu Programme hinzufügen oder entfernen in der Systemsteuerung hinzu.

Festlegen der ClickOnce-Veröffentlichungsversion

Die ClickOnce-Eigenschaft Publish Version legt fest, ob die zu veröffentlichende Anwendung als Update behandelt wird oder nicht. Bei jeder Erhöhung der Version wird die Anwendung als Update veröffentlicht.

Die Eigenschaft Publish Version kann auf der Seite Veröffentlichen des Projekt-Designers festgelegt werden.

Hinweis

Es gibt eine Projektoption, die die Eigenschaft Publish Version bei jeder Veröffentlichung der Anwendung automatisch erhöht; diese Option ist standardmäßig aktiviert. Weitere Informationen dazu finden Sie unter Automatisches Aufrüsten der ClickOnce Publish-Version.

Ändern der Publish-Version

  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. Erhöhen Sie im Feld Veröffentlichungsversion die Versionsnummern für Hauptversion, Nebenversion, Build oder Revision.

    Hinweis

    Sie sollten niemals eine Versionsnummer verringern, da dies zu einem unvorhersehbaren Aktualisierungsverhalten führen kann.

Automatisches Erhöhen der ClickOnce-Veröffentlichungsversion

Wenn Sie eine ClickOnce-Anwendung veröffentlichen, wird die Anwendung durch Ändern der Publish Version-Eigenschaft als Update veröffentlicht. Standardmäßig inkrementiert Visual Studio bei jeder Veröffentlichung der Anwendung automatisch die Revision-Nummer der Publish Version.

Sie können dieses Verhalten auf der Seite Veröffentlichen des Projekt-Designers deaktivieren.

Hinweis

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren , um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Reset settings (Zurücksetzen der Einstellungen).

So deaktivieren Sie die automatische Aufrüstung der Publish-Version

  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. Deaktivieren Sie im Abschnitt Veröffentlichungsversion das Kontrollkästchen Revision automatisch mit jedem Release inkrementieren.

Zugehöriger Inhalt