Festlegen von ClickOnce-Veröffentlichungseigenschaften

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 Eigenschaften wie den Veröffentlichungsort, die Installations-URL, den Online- oder Offline-Installationsmodus 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.

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

2. Klicken Sie auf die Registerkarte Veröffentlichen.

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.

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.

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.

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.

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.

Ä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.

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.

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.

3. Deaktivieren Sie im Abschnitt Veröffentlichungsversion das Kontrollkästchen Revision automatisch mit jedem Release inkrementieren.

Angeben einer Veröffentlichungsseite für eine ClickOnce-Anwendung

Beim Veröffentlichen einer ClickOnce-Anwendung wird eine Standardwebseite (publish.htm) generiert und zusammen mit der Anwendung veröffentlicht. Diese Seite enthält den Namen der Anwendung, einen Link zum Installieren der Anwendung und/oder aller erforderlichen Komponenten sowie einen Link zu einem Hilfethema, in dem ClickOnce beschrieben wird. Mit der Publish Page-Eigenschaft für Ihr Projekt können Sie eine Webseite für Ihre ClickOnce-Anwendung angeben.

Sobald die Veröffentlichungsseite angegeben wurde, wird sie beim nächsten Veröffentlichen an den Veröffentlichungsort kopiert. Sie wird nicht überschrieben, wenn Sie erneut veröffentlichen. Wenn Sie die Darstellung der Seite anpassen möchten, können Sie dies tun, ohne sich Gedanken über den Verlust Ihrer Änderungen machen zu müssen. Weitere Informationen finden Sie unter Anpassen der ClickOnce-Standardwebseite.

Die Publish Page-Eigenschaft kann im Dialogfeld Veröffentlichungsoptionen festgelegt werden, auf das über die Seite Veröffentlichen des Projekt-Designers zugegriffen werden kann.

So legen Sie eine benutzerdefinierte Webseite für eine ClickOnce-Anwendung fest:

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

2. Wählen Sie den Bereich Veröffentlichen aus.

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

4. Klicken Sie auf Bereitstellung.

5. Stellen Sie im Dialogfeld Veröffentlichungsoptionen sicher, dass das Kontrollkästchen Bereitstellungswebseite nach dem Veröffentlichen öffnen aktiviert ist (es sollte standardmäßig aktiviert sein).

6. Geben Sie im Feld Bereitstellungswebseite den Namen für Ihre Webseite ein, und klicken Sie dann auf OK.

So verhindern Sie, dass die Veröffentlichungsseite bei jeder Veröffentlichung gestartet wird:

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

2. Wählen Sie den Bereich Veröffentlichen aus.

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

4. Klicken Sie auf Bereitstellung.

5. Deaktivieren Sie im Dialogfeld Veröffentlichungsoptionen das Kontrollkästchen Bereitstellungswebseite nach dem Veröffentlichen öffnen.

Anpassen der Standardwebseite für eine ClickOnce-Anwendung

Beim Veröffentlichen einer ClickOnce-Anwendung im Web wird automatisch eine Webseite generiert und zusammen mit der Anwendung veröffentlicht. Die Standardseite enthält den Namen der Anwendung und Links zum Installieren der Anwendung und der erforderlichen Komponenten oder zum Zugreifen auf Hilfe auf MSDN.

Der Standardname für die Webseite lautet Publish.htm. Sie können den Namen im Projekt-Designer ändern. Weitere Informationen finden Sie unter Angeben einer Veröffentlichungsseite für eine ClickOnce-Anwendung.

Die Webseite Publish.htm wird nur veröffentlicht, wenn eine neuere Version erkannt wird.

So passen Sie die Veröffentlichungswebseite an:

1. Veröffentlichen Sie Ihre ClickOnce-Anwendung an einem Webspeicherort. Weitere Informationen finden Sie unter Veröffentlichen einer ClickOnce-Anwendung mit dem Webpublishing-Assistenten.

2. Öffnen Sie auf dem Webserver die Datei Publish.htm in Visual Web Designer oder einem anderen HTML-Editor.

3. Passen Sie die Seite wie gewünscht an, und speichern Sie sie.

4. Optional. Um zu verhindern, dass Visual Studio Ihre angepasste Veröffentlichungswebseite überschreibt, deaktivieren Sie nach jeder Veröffentlichung im Dialogfeld Veröffentlichungsoptionen die Option Bereitstellungswebseite nach jeder Veröffentlichung automatisch generieren.

Angeben eines Links für den technischen Support

Beim Veröffentlichen einer ClickOnce-Anwendung identifiziert die Eigenschaft Support-URL eine Webseite oder Dateifreigabe, über die Benutzer*innen Informationen über die Anwendung erhalten. Diese Eigenschaft ist optional. Wenn sie angegeben wird, wird die URL im Dialogfeld Programme hinzufügen oder entfernen der Anwendung angezeigt.

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

So geben Sie eine Support-URL 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 Optionen, um das Dialogfeld Veröffentlichungsoptionen zu öffnen.

4. Klicken Sie auf Beschreibung.

5. Geben Sie im Feld Support-URL einen vollqualifizierten Pfad zu einer Website, Webseite oder UNC-Freigabe ein.

Angeben einer Support-URL für einzelne erforderliche Komponenten in einer ClickOnce-Bereitstellung

Eine ClickOnce-Bereitstellung kann das Vorhandensein einer Reihe erforderlicher Komponenten überprüfen, die auf dem Clientcomputer verfügbar sein müssen, damit die ClickOnce-Anwendung ausgeführt werden kann. Zu diesen Abhängigkeiten gehören die erforderliche Mindestversion des .NET Framework, die Version des Betriebssystems und alle Assemblys, die im globalen Assemblycache (GAC) vorinstalliert werden müssen. ClickOnce kann jedoch keine dieser erforderlichen Komponenten selbst installieren. Wenn eine Voraussetzung nicht gefunden wird, wird die Installation einfach angehalten und ein Dialogfeld angezeigt, in dem erläutert wird, warum die Installation fehlgeschlagen ist.

Es gibt zwei Methoden zum Installieren der erforderlichen Komponenten. Sie können sie mithilfe einer Bootstrapperanwendung installieren. Alternativ können Sie eine Support-URL für einzelne erforderliche Komponenten angeben, die Benutzer*innen im Dialogfeld angezeigt wird, wenn die Komponente nicht gefunden wird. Die Seite, auf die diese URL verweist, kann Links zu Anweisungen zum Installieren der erforderlichen Komponenten enthalten. Wenn eine Anwendung keine Support-URL für eine erforderliche Komponente angibt, zeigt ClickOnce die im Bereitstellungsmanifest für die gesamte Anwendung angegebene Support-URL an, sofern eine solche definiert ist.

Während sowohl Visual Studio als auch Mage.exeund MageUI.exe zum Generieren von ClickOnce-Bereitstellungen verwendet werden können, unterstützt keines dieser Tools das direkte Angeben einer Support-URL für einzelne erforderliche Komponenten. In diesem Dokument wird beschrieben, wie Sie diese Support-URLs in das Anwendungsmanifest und das Bereitstellungsmanifest Ihrer Bereitstellung eintragen.

Angeben einer Support-URL für eine einzelne erforderlich Komponente

1. Öffnen Sie das Anwendungsmanifest (die .manifest-Datei) für die ClickOnce-Anwendung in einem Text-Editor.

2. Fügen Sie für eine Betriebssystemvoraussetzung dem Element dependentOS das Attribut supportUrl hinzu:

    <dependency>
       <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
         <osVersionInfo>
           <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
         </osVersionInfo>
       </dependentOS>
     </dependency>
   

3. Fügen Sie als Voraussetzung für eine bestimmte Version der Common Language Runtime dem Eintrag dependentAssembly das Attribut supportUrl hinzu, das die Common Language Runtime-Abhängigkeit spezifiziert:

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
         <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
       </dependentAssembly>
     </dependency>
   

4. Bei einer Voraussetzung für eine Assembly, die im globalen Assemblycache vorinstalliert sein muss, legen Sie die supportUrl für das Element dependentAssembly fest, das die erforderliche Assembly angibt:

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
         <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
       </dependentAssembly>
     </dependency>
   

5. Optional. Öffnen Sie für Anwendungen, die auf die .NET Framework 4 abzielen, das Bereitstellungsmanifest (die .application-Datei) für die ClickOnce-Anwendung in einem Text-Editor.

6. Fügen Sie für eine .NET Framework 4-Voraussetzung das dem Element compatibleFrameworks das Attribut supportUrl hinzu:

   <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
     <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
     <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
   </compatibleFrameworks>
   

7. Nachdem Sie das Anwendungsmanifest manuell geändert haben, müssen Sie es mithilfe Ihres digitalen Zertifikats erneut signieren und dann auch das Bereitstellungsmanifest aktualisieren und erneut signieren. Verwenden Sie die Mage.exe- oder MageUI.exe-SDK-Tools, um diese Aufgabe zu erledigen, da durch die Neugenerierung dieser Dateien mithilfe von Visual Studio Ihre manuellen Änderungen gelöscht würden. Weitere Informationen zur Verwendung von Mage.exe zum erneuten Signieren von Manifesten finden Sie unter Gewusst wie: Erneutes Signieren von Anwendungs- und Bereitstellungsmanifesten.

.NET Framework-Sicherheit

Die Support-URL wird im Dialogfeld nicht angezeigt, wenn die Anwendung so markiert ist, dass sie als teilweise vertrauenswürdig ausgeführt wird.

Ändern der Veröffentlichungssprache einer ClickOnce-Anwendung

Beim Veröffentlichen einer ClickOnce-Anwendung wird die während der Installation angezeigte Benutzeroberfläche standardmäßig auf die Sprache und Kultur Ihres Entwicklungscomputers festgelegt. Wenn Sie eine lokalisierte Anwendung veröffentlichen, müssen Sie eine Sprache und Kultur angeben, die der lokalisierten Version entspricht. Dies wird durch die Publish language-Eigenschaft für Ihr Projekt bestimmt.

Die Publish language-Eigenschaft kann im Dialogfeld Veröffentlichungsoptionen festgelegt werden, auf das über die Seite Veröffentlichen des Projekt-Designers zugegriffen werden kann.

So ändern Sie die Veröffentlichungssprache:

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 Optionen, um das Dialogfeld Veröffentlichungsoptionen zu öffnen.

4. Klicken Sie auf Beschreibung.

5. Wählen Sie im Dialogfeld Veröffentlichungsoptionen in der Dropdownliste Sprache für Veröffentlichung eine Sprache und Kultur aus, und klicken Sie dann auf OK.

Angeben eines Namens im Startmenü für eine ClickOnce-Anwendung

Wenn eine ClickOnce-Anwendung sowohl für Online- als auch Offlineverwendung installiert wird, wird dem Startmenü und der Liste Software ein Eintrag hinzugefügt. Standardmäßig entspricht der Anzeigename dem Namen der Anwendungsassembly. Sie können den Anzeigenamen jedoch ändern, indem Sie im Dialogfeld Veröffentlichungsoptionen einen Namen unter Produktname festlegen.

Der Produktname wird auf der Seite publish.htm angezeigt. Bei einer installierten Offlineanwendung ist dies der Name des Eintrags im Startmenü und auch der Name, der unter Software angezeigt wird.

Herausgebername wird auf der Seite publish.htm über Produktname angezeigt, und bei einer installierten Offlineanwendung ist dies auch der Name des Ordners, der das Symbol der Anwendung im Startmenü enthält.

Die Startmenüverknüpfung oder der App-Verweis wird in %appdata%\Microsoft\Windows\Start menu\Programs\<Herausgebername> erstellt. Für die Verknüpfung bzw. den App-Verweis wird derselbe Name wie für den Produktnamen verwendet.

Sie können die Eigenschaften Produktname und Herausgebername im Dialogfeld Veröffentlichungsoptionen auf der Seite Veröffentlichen im Projekt-Designer festlegen.

So geben Sie einen Startmenünamen 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 Optionen, um das Dialogfeld Veröffentlichungsoptionen zu öffnen.

4. Wählen Sie Beschreibung aus.

5. Geben Sie im Dialogfeld Veröffentlichungsoptionen den Namen ein, der unter Produktname angezeigt werden soll.

6. Optional können Sie einen Herausgebernamen unter Herausgebername eingeben.

Aktivieren von AutoStart für Installationen von CD

Wenn Sie eine ClickOnce-Anwendung mithilfe von Wechselmedien wie CD-ROM oder DVD-ROM bereitstellen, können Sie AutoStart aktivieren, damit die ClickOnce-Anwendung automatisch gestartet wird, wenn das Medium eingelegt wird.

AutoStart kann auf der Seite Veröffentlichen des Projekt-Designers aktiviert werden.

So aktivieren Sie AutoStart:

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 Optionen .

   Das Dialogfeld Veröffentlichungsoptionen wird angezeigt.

4. Klicken Sie auf Bereitstellung.

5. Aktivieren Sie das Kontrollkästchen Bei CD-Installationen automatisch Setup starten, wenn CD eingelegt wird.

   Eine Autorun.inf-Datei wird an den Veröffentlichungsort kopiert, wenn die Anwendung veröffentlicht wird.

Zugehöriger Inhalt

• Veröffentlichen von ClickOnce-Anwendungen
• How to: Publish a ClickOnce application using the Publish Wizard (Vorgehensweise: Veröffentlichen einer ClickOnce-Anwendung mit dem Veröffentlichungs-Assistenten)