Verwalten von Aktualisierungen für eine ClickOnce-Anwendung

  • Artikel

ClickOnce-Anwendungen können automatisch oder programmgesteuert nach Updates suchen. Als Entwickler können Sie sehr flexibel angeben, wann und wie Updateprüfungen durchgeführt werden, ob Updates obligatorisch sind und wo die Anwendung nach Updates suchen soll.

Sie können die Anwendung so konfigurieren, dass sie automatisch vor dem Start oder in festgelegten Intervallen nach dem Start nach Updates sucht. Darüber hinaus können Sie eine erforderliche Mindestversion angeben. Das heißt, ein Update wird installiert, wenn die Benutzerversion niedriger als die erforderliche Version ist.

Sie können die Anwendung so konfigurieren, dass sie programmgesteuert auf Grundlage eines Ereignisses wie einer Benutzeranforderung nach Updates sucht. Das Verfahren „So suchen Sie programmgesteuert nach Updates“ in diesem Thema zeigt, wie Sie Code schreiben, der die ApplicationDeployment-Klasse verwendet, um basierend auf einem Ereignis nach Updates zu suchen.

Hinweis

Die Klasse ApplicationDeployment und die APIs im Namespace System.Deployment.Application werden in .NET Core und .NET 5 und höheren Versionen nicht unterstützt. In .NET 7 wird eine neue Methode für den Zugriff auf Anwendungsbereitstellungseigenschaften unterstützt. Weitere Informationen finden Sie unter Zugreifen auf ClickOnce-Bereitstellungseigenschaften in .NET. .NET 7 unterstützt nicht das Äquivalent von ApplicationDeployment-Methoden.

Sie können Ihre Anwendung auch von einem Speicherort aus bereitstellen und von einem anderen aus aktualisieren. Weitere Informationen finden Sie im Verfahren „So geben Sie einen anderen Updatespeicherort an“.

Weitere Informationen finden Sie unter Auswählen einer ClickOnce-Updatestrategie.

Das Updateverhalten wird im Dialogfeld Anwendungsupdates verwaltet, das auf der Seite Veröffentlichen des Projekt-Designers verfügbar ist.

So suchen Sie nach Updates, bevor die Anwendung gestartet wird

  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 Updates, um das Dialogfeld Anwendungsupdates zu öffnen.

  4. Stellen Sie im Dialogfeld Anwendungsupdates sicher, dass das Kontrollkästchen Die Anwendung soll nach Updates suchen aktiviert ist.

  5. Wählen Sie im Abschnitt Zeitpunkt für Updateüberprüfungen auswählen die Option Vor Start der Anwendung aus. Dadurch wird sichergestellt, dass Benutzer*innen, die mit dem Netzwerk verbunden sind, die Anwendung immer mit den neuesten Updates ausführen.

Suchen nach Updates im Hintergrund nach dem Start der Anwendung

  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 Updates, um das Dialogfeld Anwendungsupdates zu öffnen.

  4. Stellen Sie im Dialogfeld Anwendungsupdates sicher, dass das Kontrollkästchen Die Anwendung soll nach Updates suchen aktiviert ist.

  5. Wählen Sie im Abschnitt Zeitpunkt für Updateüberprüfungen auswählen die Option Nach dem Starten der Anwendung aus. Die Anwendung wird auf diese Weise schneller gestartet, sucht dann im Hintergrund nach Updates und benachrichtigt Benutzer*innen nur, wenn ein Update verfügbar ist. Nach der Installation werden Updates erst wirksam, wenn die Anwendung neu gestartet wird.

  6. Wählen Sie im Abschnitt Häufigkeit der Überprüfung auf Updates angeben entweder Bei jedem Ausführen der Anwendung überprüfen (Standard) oder Überprüfung alle aus, und geben Sie eine Zahl und ein Zeitintervall ein.

Hinweis

In ClickOnce für .NET Core und .NET 5 oder höher wird diese Aufgabe nicht unterstützt. Weitere Informationen finden Sie unter ClickOnce für .NET.

So geben Sie eine mindestens erforderliche Version für die Anwendung an

  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 Updates, um das Dialogfeld Anwendungsupdates zu öffnen.

  4. Stellen Sie im Dialogfeld Anwendungsupdates sicher, dass das Kontrollkästchen Die Anwendung soll nach Updates suchen aktiviert ist.

  5. Aktivieren Sie das Kontrollkästchen Mindestens erforderliche Version für diese Anwendung angeben, und geben Sie dann Haupt-, Neben-, Build- und Revisionsnummer für die Anwendung ein.

So geben Sie einen anderen Updatespeicherort an

  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 Updates, um das Dialogfeld Anwendungsupdates zu öffnen.

  4. Stellen Sie im Dialogfeld Anwendungsupdates sicher, dass das Kontrollkästchen Die Anwendung soll nach Updates suchen aktiviert ist.

  5. Geben Sie im Feld Updatepfad den Updatespeicherort mit einer vollqualifizierten URL im Format http://Hostname/ApplicationName oder einen UNC-Pfad im Format \\Server\ApplicationName ein, oder klicken Sie auf die Schaltfläche Durchsuchen, um nach dem Updatespeicherort zu suchen.

So suchen Sie programmgesteuert nach Updates

  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 Updates, um das Dialogfeld Anwendungsupdates zu öffnen.

  4. Stellen Sie im Dialogfeld Anwendungsupdates sicher, dass das Kontrollkästchen Die Anwendung soll nach Updates suchen deaktiviert ist. (Optional können Sie dieses Kontrollkästchen aktivieren, um programmgesteuert nach Updates zu suchen und die ClickOnce-Runtime automatisch nach Updates suchen zu lassen.)

  5. Geben Sie im Feld Updatepfad den Updatespeicherort mit einer vollqualifizierten URL im Format http://Hostname/ApplicationName oder einen UNC-Pfad im Format \\Server\ApplicationName ein, oder klicken Sie auf die Schaltfläche Durchsuchen, um nach dem Updatespeicherort zu suchen. Der Updatespeicherort ist der Ort, an dem die Anwendung nach einer aktualisierten Version von sich selbst sucht.

  6. Erstellen Sie eine Schaltfläche, ein Menüelement oder ein anderes Benutzeroberflächenelement in einem Windows Form, das Benutzer*innen auswählen, um nach Updates zu suchen. Rufen Sie im Ereignishandler dieses Elements eine Methode auf, um nach Updates zu suchen und diese zu installieren. Ein Beispiel für Visual Basic- und Visual C#-Code für eine solche Methode finden Sie unter Vorgehensweise: Programmgesteuertes Suchen nach Anwendungsupdates mit der API für die ClickOnce-Bereitstellung.

  7. Erstellen Sie Ihre Anwendung.

Zugehöriger Inhalt