Sprache

Verwalten von Updates für eine ClickOnce-Anwendung

ClickOnce-Anwendungen können automatisch oder programmgesteuert nach Updates suchen. Als Entwickler haben Sie viel Flexibilität bei der Angabe, 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 vor dem Start der Anwendung automatisch nach Updates gesucht wird, oder in festgelegten Intervallen nach dem Start der Anwendung. Darüber hinaus können Sie eine mindest erforderliche Version angeben; d. h. ein Update wird installiert, wenn die Version des Benutzers niedriger als die erforderliche Version ist.

Sie können die Anwendung so konfigurieren, dass sie programmgesteuert basierend auf einem Ereignis wie einer Benutzeranforderung nach Updates sucht. Das Verfahren "Programmgesteuerte Überprüfung auf Updates" in diesem Thema zeigt, wie Sie Code schreiben, der die <xref:System.Deployment.Application.ApplicationDeployment> Klasse verwendet, um basierend auf einem Ereignis nach Updates zu suchen.

Note

Die <xref:System.Deployment.Application.ApplicationDeployment> Klasse und APIs im <xref:System.Deployment.Application> Namespace werden in .NET Core und .NET 5 und höher nicht unterstützt. In .NET 7 wird eine neue Methode für den Zugriff auf Anwendungsbereitstellungseigenschaften unterstützt. Weitere Informationen finden Sie unter Access 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 aktualisieren. Lesen Sie das Verfahren „So geben Sie einen anderen Speicherort für Updates 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 Project-Designers verfügbar ist.

So überprüfen Sie vor dem Start der Anwendung nach Updates

  1. Wenn ein Projekt im Lösungs-Explorerausgewählt ist, klicken Sie im Projektmenü auf Eigenschaften.

  2. Klicken Sie auf die Registerkarte "Veröffentlichen ".

    Note

    In ClickOnce für .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 Project-Designers fest. Weitere Informationen finden Sie unter Bereitstellen einer .NET-Windows-Anwendung mit 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 "Auf Updates überprüfen " der Anwendung aktiviert ist.

  5. Wählen Sie im Abschnitt " Auswählen, wann die Anwendung nach Updates suchen soll " die Option "Vor dem Starten der Anwendung" aus. Dadurch wird sichergestellt, dass Benutzer, die mit dem Netzwerk verbunden sind, immer die Anwendung mit den neuesten Updates ausführen.

Im Hintergrund nach dem Anwendungsstart nach Aktualisierungen suchen

  1. Wenn ein Projekt im Lösungs-Explorerausgewählt ist, klicken Sie im Projektmenü 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 auf Updates überprüfen" aktiviert ist.

  5. Wählen Sie im Abschnitt "Auswählen, wann die Anwendung nach Updates suchen soll" die Option "Nach dem Starten der Anwendung" aus. Die Anwendung wird auf diese Weise schneller gestartet, und dann wird im Hintergrund nach Updates gesucht, und der Benutzer wird nur benachrichtigt, 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 " Angeben, wie häufig die Anwendung nach Aktualisierungen suchen soll " entweder bei jeder Ausführung der Anwendung (Standard) oder "Überprüfen" aus , und geben Sie eine Zahl und ein Zeitintervall ein.

Note

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 erforderliche Mindestversion für die Anwendung an

  1. Wenn ein Projekt im Lösungs-Explorerausgewählt ist, klicken Sie im Projektmenü 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 "Auf Updates überprüfen " der Anwendung aktiviert ist.

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

Einen anderen Speicherort für Updates angeben

  1. Wenn ein Projekt im Lösungs-Explorerausgewählt ist, klicken Sie im Projektmenü 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 "Auf Updates überprüfen " der Anwendung aktiviert ist.

  5. Geben Sie im Feld Speicherort aktualisieren den Updatespeicherort mit einer vollqualifizierten URL im Format http://Hostname/ApplicationName oder mit einem UNC-Pfad im Format \\Server\ApplicationName ein, oder klicken Sie auf die Schaltfläche Durchsuchen, um den Updatespeicherort auszuwählen.

Programmgesteuert auf Updates prüfen

  1. Wenn ein Projekt im Lösungs-Explorerausgewählt ist, klicken Sie im Projektmenü 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 "Auf Updates überprüfen " der Anwendung aktiviert ist. (Optional können Sie dieses Kontrollkästchen aktivieren, um programmgesteuert nach Updates zu suchen und die ClickOnce-Laufzeit automatisch auf Updates zu überprüfen.)

  5. Geben Sie im Feld Update location den Updatespeicherort mit einer vollqualifizierten URL im Format http://Hostname/ApplicationName oder als UNC-Pfad im Format \\Server\ApplicationName ein, oder klicken Sie auf die Schaltfläche „Durchsuchen“, um den Updatespeicherort auszuwählen. 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 Formular, das Benutzer auswählen, um nach Updates zu suchen. Rufen Sie im Ereignishandler dieses Elements eine Methode auf, um nach Updates zu suchen und zu installieren. Ein Beispiel für Visual Basic- und Visual C#-Code für eine solche Methode finden Sie unter How to: Check for application updates programmatically using the ClickOnce deployment API.

  7. Erstellen Sie Ihre Anwendung.

Verwandte Inhalte

  • Last updated on