Beheben von spezifischen Fehlern in ClickOnce-Bereitstellungen
Gilt für: Visual Studio
In diesem Artikel werden häufige Fehler vorgestellt, die beim Bereitstellen der ClickOnce-Anwendung auftreten können, und enthält Schritte zum Beheben der einzelnen Probleme.
Allgemeine Fehler
Wenn Sie versuchen, nach einer Anwendungsdatei zu suchen, nichts geschieht, XML in Internet Explorer gerendert oder ein Dialogfeld „Ausführen“ oder „Speichern unter“ angezeigt wird.
Der mögliche Grund für diesen Fehler ist, dass Inhaltstypen (auch als MIME-Typen bezeichnet) nicht ordnungsgemäß auf dem Server oder Client registriert werden.
Stellen Sie zunächst sicher, dass der Server so konfiguriert ist, dass die Anwendungserweiterung dem Inhaltstyp "application/x-ms-application" zugeordnet wird.
Wenn der Server ordnungsgemäß konfiguriert ist, stellen Sie sicher, dass .NET Framework 2.0 auf Ihrem Computer installiert ist. Wenn .NET Framework 2.0 installiert ist und dieses Problem weiterhin auftritt, versuchen Sie, .NET Framework 2.0 zu deinstallieren und erneut zu installieren, um den Inhaltstyp auf dem Client erneut zu registrieren.
Fehler: "Anwendung kann nicht abgerufen werden. Dateien fehlen in der Bereitstellung.“ oder „Anwendungsdownload wurde unterbrochen, prüfen Sie auf Netzwerkfehler, und versuchen Sie es später erneut“.
Diese Meldung gibt an, dass mindestens eine Datei, auf die die ClickOnce-Manifeste verweisen, nicht heruntergeladen werden kann. Die einfachste Möglichkeit zum Debuggen dieses Fehlers besteht darin, die URL herunterzuladen, die ClickOnce besagt, dass er nicht heruntergeladen werden kann. Nachfolgend werden einige mögliche Ursachen aufgeführt:
- Wenn die Protokolldatei "(403) Verboten" oder "(404) Nicht gefunden" lautet, überprüfen Sie, ob der Webserver so konfiguriert ist, dass der Download dieser Datei nicht blockiert wird. Weitere Informationen finden Sie unter Probleme mit der Server- und Clientkonfiguration in ClickOnce-Bereitstellungen.
- Wenn die CONFIG-Datei vom Server blockiert wird, lesen Sie den Downloadfehler, wenn Sie versuchen, eine ClickOnce-Anwendung mit einer CONFIG-Datei zu installieren.
- Ermitteln Sie, ob dieser Fehler aufgetreten ist, weil die
deploymentProvider
-URL im Bereitstellungsmanifest auf einen anderen Ort als die für die Aktivierung verwendete URL verweist. - Stellen Sie sicher, dass alle Dateien auf dem Server vorhanden sind; Das ClickOnce-Protokoll sollte Ihnen mitteilen, welche Datei nicht gefunden wurde.
- Überprüfen Sie, ob Probleme mit der Netzwerkkonnektivität vorliegen. Sie können diese Meldung erhalten, wenn Ihr Clientcomputer während des Downloads offline geschaltet wurde.
Downloadfehler beim Versuch, eine ClickOnce-Anwendung mit einer CONFIG-Datei zu installieren
Standardmäßig enthält eine windowsbasierte Visual Basic-Anwendung eine App.config-Datei . Möglicherweise tritt ein Problem auf, wenn Sie versuchen, von einem Webserver zu installieren, der Windows Server 2003 verwendet, da das Betriebssystem die Installation von CONFIG-Dateien aus Sicherheitsgründen blockiert. Um die zu installierende CONFIG-Datei zu aktivieren, wählen Sie die Dateierweiterung ".deploy" im Dialogfeld "Veröffentlichungsoptionen" aus.
Außerdem müssen Sie die Inhaltstypen (auch als MIME-Typen bezeichnet) entsprechend für ANWENDUNGS-, MANIFEST- und BEREITSTELLUNGSdateien festlegen. Weitere Informationen finden Sie in der Webserverdokumentation.
Weitere Informationen finden Sie unter Windows Server: Gesperrte Inhaltstypen.
Fehler: Die Anwendung ist nicht ordnungsgemäß formatiert; Die Protokolldatei enthält "XML-Signatur ist ungültig"
Stellen Sie sicher, dass Sie die Manifestdatei aktualisiert und erneut signiert haben. Veröffentlichen Sie Ihre Anwendung erneut, indem Sie Visual Studio verwenden, oder verwenden Sie Mage, um die Anwendung erneut zu signieren.
Sie haben Ihre Anwendung auf dem Server aktualisiert, der Client lädt das Update jedoch nicht herunter.
Dieses Problem kann gelöst werden, indem Sie eine der folgenden Aufgaben ausführen:
- Überprüfen Sie die
deploymentProvider
-URL im Bereitstellungsmanifest. Stellen Sie sicher, dass Sie die Bits an derselben Stelle aktualisieren, auf diedeploymentProvider
verweist. - Überprüfen Sie das Updateintervall im Bereitstellungsmanifest. Wenn dieses Intervall auf ein periodisches Intervall festgelegt ist, z. B. einmal alle sechs Stunden, sucht ClickOnce erst nach einer Aktualisierung, nachdem dieses Intervall übergeben wurde. Sie können das Manifest so ändern, dass bei jedem Anwendungsstart nach einem Update gesucht wird. Das Ändern des Updateintervalls ist während der Entwicklungszeit eine praktische Option, um zu überprüfen, ob Updates installiert werden, aber sie verlangsamt die Anwendungsaktivierung.
- Versuchen Sie, die Anwendung im Startmenü erneut zu starten. ClickOnce hat das Update möglicherweise im Hintergrund erkannt, fordert Sie jedoch auf, die Bits bei der nächsten Aktivierung zu installieren.
Während des Updates erhalten Sie einen Fehler, der den folgenden Protokolleintrag aufweist: "Der Verweis in der Bereitstellung stimmt nicht mit der identität überein, die im Anwendungsmanifest definiert ist"
Dieser Fehler kann auftreten, weil Sie die Bereitstellungs- und Anwendungsmanifeste manuell bearbeitet haben und die Beschreibung der Identität einer Assembly in einem Manifest zur Synchronisierung mit dem anderen verursacht haben. Die Identität einer Assembly besteht aus dem Namen, der Version, der Kultur und dem Token für den öffentlichen Schlüssel. Untersuchen Sie die Identitätsbeschreibungen in Ihren Manifesten, und korrigieren Sie alle Unterschiede.
Die erstmalige Aktivierung von einem lokalen Datenträger oder CD-ROM ist erfolgreich, die nachfolgende Aktivierung aus dem Startmenü ist jedoch nicht erfolgreich.
ClickOnce verwendet die URL des Bereitstellungsanbieters, um Updates für die Anwendung zu erhalten. Überprüfen Sie, ob der Ort, auf den die URL verweist, richtig ist.
Fehler: Die Anwendung kann nicht gestartet werden.
Diese Fehlermeldung weist in der Regel darauf hin, dass beim Installieren dieser Anwendung im ClickOnce-Speicher ein Problem auftritt. Entweder weist die Anwendung einen Fehler auf, oder der Speicher ist beschädigt. Der Protokolldatei können Sie ggf. entnehmen, wo der Fehler aufgetreten ist.
Gehen Sie folgendermaßen vor, um das Problem zu beheben:
- Stellen Sie sicher, dass die Identität des Bereitstellungsmanifests, die Identität des Anwendungsmanifests und die Identität der Hauptanwendungs-EXE eindeutig sind.
- Stellen Sie sicher, dass Ihre Dateipfade nicht länger als 100 Zeichen sind. Wenn Ihre Anwendung Dateipfade enthält, die zu lang sind, können Sie die Einschränkungen für den maximalen Pfad überschreiten, den Sie speichern können. Versuchen Sie, die Pfade zu kürzen und dann erneut zu installieren.
PrivatePath-Einstellungen in der Anwendungskonfigurationsdatei werden nicht berücksichtigt
Um PrivatePath (Fusion-Untersuchungspfade) verwenden zu können, muss die Anwendung die Berechtigung Volle Vertrauenswürdigkeit“ anfordern. Versuchen Sie, das Anwendungsmanifest so zu ändern, dass volle Vertrauenswürdigkeit angefordert wird, und versuchen Sie es dann erneut.
Während der Deinstallation wird eine Meldung angezeigt, die Folgendes besagt: „Anwendung konnte nicht deinstalliert werden“.
Diese Meldung gibt in der Regel an, dass die Anwendung bereits entfernt wurde oder der Speicher beschädigt ist. Nachdem Sie "OK" ausgewählt haben, wird der Eintrag "Programm hinzufügen/entfernen" entfernt.
Während der Installation wird eine Meldung angezeigt, dass die Plattformabhängigkeiten nicht installiert sind.
Sie fehlen eine Voraussetzung im GAC (globaler Assemblycache), die die Anwendung benötigt, um ausgeführt werden zu können.
Veröffentlichen mit Visual Studio
Fehler bei der Veröffentlichung in Visual Studio
Stellen Sie sicher, dass Sie das Recht haben, auf dem Server zu veröffentlichen, auf den Sie abzielen. Wenn Sie beispielsweise als gewöhnlicher Benutzer bei einem Terminalservercomputer angemeldet sind, nicht als Administrator, verfügen Sie wahrscheinlich nicht über die erforderlichen Berechtigungen zum Veröffentlichen auf dem lokalen Webserver.
Wenn Sie eine URL veröffentlichen, stellen Sie sicher, dass auf dem Zielcomputer FrontPage-Servererweiterungen aktiviert sind.
Fehler: Die Website '<site>' kann nicht erstellt werden. Die Komponenten für die Kommunikation mit FrontPage-Servererweiterungen sind nicht installiert.
Stellen Sie sicher, dass die Microsoft Visual Studio Web Authoring Component auf dem Computer installiert ist, von dem Sie veröffentlichen. Für Express-Benutzer ist diese Komponente nicht standardmäßig installiert.
Fehler: Die Datei "Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32" konnte nicht gefunden werden.
Diese Fehlermeldung wird angezeigt, wenn Sie versuchen, eine WPF-Anwendung mit aktivierten visuellen Stilen zu veröffentlichen. Informationen zum Beheben dieses Problems finden Sie unter Vorgehensweise: Veröffentlichen einer WPF-Anwendung mit aktivierten visuellen Stilen.
Verwenden von Mage
Sie haben versucht, mit einem Zertifikat in Ihrem Zertifikatspeicher und einem empfangenen leeren Meldungsfeld zu signieren.
Im Dialogfeld Signieren müssen Sie folgendermaßen vorgehen:
- Wählen Sie " Mit einem gespeicherten Zertifikat signieren" aus.
- Wählen Sie ein Zertifikat aus der Liste aus; Das erste Zertifikat ist nicht die Standardauswahl.
Wenn Sie auf die Schaltfläche „Nicht signieren“ klicken, wird eine Ausnahme ausgelöst.
Dieses Problem ist ein bekannter Fehler. Alle ClickOnce-Manifeste müssen signiert werden. Wählen Sie einfach eine der Signaturoptionen und dann "OK" aus.
Weitere Fehler
Die folgende Tabelle enthält einige häufig auftretende Fehlermeldungen, die ein Clientcomputerbenutzer möglicherweise erhält, wenn der Benutzer eine ClickOnce-Anwendung installiert. Jede Fehlermeldung wird neben einer Beschreibung der wahrscheinlichsten Ursache für den Fehler aufgeführt.
Fehlermeldung | BESCHREIBUNG |
---|---|
Die Anwendung kann nicht gestartet werden. Wenden Sie sich an den Herausgeber der Anwendung. Die Anwendung kann nicht gestartet werden. Wenden Sie sich an den Hersteller der Anwendung, um Unterstützung zu erhalten. |
Dies sind generische Fehlermeldungen, die auftreten, wenn die Anwendung nicht gestartet werden kann und kein anderer spezifischer Grund gefunden wurde. Häufig bedeutet dies, dass die Anwendung oder der ClickOnce-Speicher beschädigt ist. |
Der Vorgang kann nicht fortgesetzt werden. Die Anwendung ist falsch formatiert. Wenden Sie sich an den Herausgeber der Anwendung, um Unterstützung zu erhalten. Die Anwendungsüberprüfung war nicht erfolgreich. Der Vorgang kann nicht fortgesetzt werden. Anwendungsdateien können nicht abgerufen werden. Dateien in der Bereitstellung sind beschädigt. |
Eine der Manifestdateien in der Bereitstellung ist syntaktisch ungültig oder enthält einen Hashwert, der nicht mit der entsprechenden Datei abgeglichen werden kann. Dieser Fehler kann auch darauf hinweisen, dass das in eine Assembly eingebettete Manifest beschädigt ist. Erstellen Sie Ihre Bereitstellung neu, und kompilieren Sie Ihre Anwendung erneut, oder suchen Sie die Fehler in Ihren Manifesten, und beheben Sie sie manuell. |
Die Anwendung kann nicht abgerufen werden. Authentifizierungsfehler. Die Anwendungsinstallation war nicht erfolgreich. Anwendungsdateien auf dem Server wurden nicht gefunden. Wenden Sie sich an den Herausgeber der Anwendung oder Ihren Administrator, um Hilfe zu erhalten. |
Mindestens eine Datei in der Bereitstellung kann nicht heruntergeladen werden, da Sie nicht über die Berechtigung zum Zugriff verfügen. Dies kann durch einen 403 Forbidden-Fehler verursacht werden, der von einem Webserver zurückgegeben wird. Dieser Fehler kann auftreten, wenn eine der Dateien in Ihrer Bereitstellung mit einer Erweiterung endet, durch die der Webserver sie als geschützte Datei behandelt. Außerdem erfordert ein Verzeichnis, das mindestens eine der Dateien der Anwendung enthält, möglicherweise einen Benutzernamen und ein Kennwort für den Zugriff. |
Die Anwendung kann nicht heruntergeladen werden. Der Anwendung fehlen erforderliche Dateien. Wenden Sie sich an den Hersteller der Anwendung oder Ihren Systemadministrator, um Unterstützung zu erhalten. | Mindestens eine der im Anwendungsmanifest aufgeführten Dateien wurde auf dem Server nicht gefunden. Überprüfen Sie, ob Sie alle abhängigen Dateien der Bereitstellung hochgeladen haben, und versuchen Sie es erneut. |
Der Anwendungsdownload war nicht erfolgreich. Überprüfen Sie Ihre Netzwerkverbindung, oder wenden Sie sich an Ihren Systemadministrator oder Netzwerkdienstanbieter. | ClickOnce kann keine Netzwerkverbindung mit dem Server herstellen. Untersuchen Sie die Verfügbarkeit des Servers und den Zustand Ihres Netzwerks. |
Fehler bei URLDownloadToCacheFile mit HRESULT „<Zahl>“. Fehler beim Herunterladen von „<Datei>“. | Wenn ein Benutzer die Option "Internet Explorer Advanced Security" auf dem Bereitstellungszielcomputer "Warnen" festgelegt hat und die Setup-URL der installierten ClickOnce-Anwendung von einer nicht unsicheren zu einer sicheren Website umgeleitet wird (oder umgekehrt), schlägt die Installation fehl, da die Internet Explorer-Warnung sie unterbricht. Zum Beheben dieses Fehlers können Sie eine der folgenden Maßnahmen ergreifen: – Deaktivieren Sie die Sicherheitsoption. – Stellen Sie sicher, dass die Setup-URL nicht so umgeleitet wird, dass sicherheitsmodi geändert werden. – Entfernen Sie die Umleitung vollständig, und verweisen Sie auf die tatsächliche Setup-URL. |
Fehler beim Schreiben auf die Festplatte. Möglicherweise ist auf dem Datenträger nicht genügend Speicherplatz verfügbar. Wenden Sie sich an den Hersteller der Anwendung oder Ihren Systemadministrator, um Unterstützung zu erhalten. | Dies kann auf unzureichenden Speicherplatz zum Speichern der Anwendung hinweisen, aber es kann auch einen allgemeineren E/A-Fehler angeben, wenn Sie versuchen, die Anwendungsdateien auf dem Laufwerk zu speichern. |
Die Anwendung kann nicht gestartet werden. Auf dem Datenträger ist nicht genügend Speicherplatz verfügbar. | Die Festplatte ist voll. Löschen Sie Speicherplatz, und versuchen Sie erneut, die Anwendung auszuführen. |
Zu viele bereitgestellte Aktivierungen versuchen den Ladevorgang gleichzeitig. | ClickOnce schränkt die Anzahl der verschiedenen Anwendungen ein, die gleichzeitig gestartet werden können. Dies dient vor allem dem Schutz vor böswilligen Versuchen, Denial-of-Service-Angriffe für den lokalen ClickOnce-Dienst zu starten. Benutzer, die versuchen, dieselbe Anwendung wiederholt und in schneller Folge zu starten, erhalten letztlich nur eine einzige Instanz der Anwendung. |
Verknüpfungen können nicht über das Netzwerk aktiviert werden. | Verknüpfungen mit einer ClickOnce-Anwendung können nur auf der lokalen Festplatte gestartet werden. Sie können nicht gestartet werden, indem eine URL geöffnet wird, die auf eine Verknüpfungsdatei auf einem Remoteserver verweist. |
Die Anwendung ist zu groß, um online teilweise vertrauenswürdig ausgeführt zu werden. Wenden Sie sich an den Hersteller der Anwendung oder Ihren Systemadministrator, um Unterstützung zu erhalten. | Eine Anwendung, die teilweise vertrauenswürdig ausgeführt wird, darf nicht größer als die Hälfte der Größe des Onlineanwendungskontingents sein, das standardmäßig 250 MB beträgt. |