Problembehandlung bei der Bereitstellung von Office-Lösungen
Gilt für: Visual Studio
In diesem Artikel wird beschrieben, wie Sie häufige Probleme lösen, die bei der Bereitstellung von Office-Lösungen auftreten können.
Die Informationen in diesem Artikel gelten für Projekte auf Dokumentebene und Visual Studio-Tools für Office-Add-In-Projekte (VSTO). Weitere Informationen finden Sie unter Verfügbare Features nach Office-Anwendung und -Projekttyp.
Problembehandlung bei Office-Lösungen mithilfe der Ereignisanzeige
Sie können die Ereignisanzeige in Windows verwenden, um Fehlermeldungen anzuzeigen, die von der Visual Studio-Tools für Office Runtime erfasst werden, wenn Sie Office-Projektmappen installieren oder deinstallieren. Sie können diese Meldungen aus der Ereignisprotokollierung verwenden, um Installations- und Bereitstellungsprobleme zu beheben. Weitere Informationen finden Sie unter Ereignisprotokollierung für Office-Lösungen.
Ändern des Assemblynamens verursacht Konflikte
Wenn Sie den Wert Assemblyname auf der Seite Anwendung des Projekt-Designer ändern, nachdem Sie bereits eine Projektmappe bereitgestellt haben, ändern die Veröffentlichungstools das Setuppaket so, dass es eine Setup.exe-Datei und zwei Bereitstellungsmanifeste enthält. Wenn Sie zwei Manifestdateien bereitstellen, können die folgenden Bedingungen auftreten:
- Wenn der Endbenutzer beide Versionen installiert, lädt die Anwendung beide VSTO-Add-Ins.
- Wenn das VSTO-Add-In installiert wurde, bevor der Assemblyname geändert wurde, erhält der Endbenutzer keine Updates.
Um diese Bedingungen zu vermeiden, ändern Sie den Wert des Assemblynamens der Lösung nicht, nachdem Sie die Lösung bereitgestellt haben.
Die Suche nach Updates dauert lange.
Visual Studio 2010 Tools for Office Runtime stellt einen Registrierungseintrag bereit, mit dem Administratoren den Timeoutwert für das Herunterladen der Manifeste und der Projektmappe festlegen können.
Festlegen des Timeoutwerts
Navigieren Sie in der Registrierung zum folgenden Schlüssel:
HKEY_CURRENT_USER\Software\Microsoft\VSTA
Legen Sie im Unterschlüssel AddInTimeout den Timeoutwert in Millisekunden fest.
Wenn der Unterschlüssel AddInTimeout nicht vorhanden ist, erstellen Sie ihn als DWORD.
Aktualisieren oder Veröffentlichen in einer Netzwerkdateifreigabe nicht möglich
Office-Lösungen, die sich auf einer Netzwerkdateifreigabe befinden, können während Updates eine irreführende Meldung anzeigen, wenn die Setup.exe-Datei der Lösung in einem Prozess gesperrt ist, während das Update veröffentlicht wird. Die Meldung kann wie folgt lauten: "Unable to add 'setup.exe' to the Web. Die Datei 'setup.exe' ist bereits in diesem Web vorhanden."
Um dateisperren zu verhindern, können Sie die Freigabe für endbenutzer schreibgeschützt festlegen. Wenn sich jedoch Dokumente in der Freigabe befinden, werden sie auch für die Endbenutzer schreibgeschützt.
Voraussetzungen für Microsoft Office sind nicht installiert
Sie können dem Setuppaket die .NET Framework, die Visual Studio-Tools für Office Runtime und die primären Office-Interopassemblys als Voraussetzungen hinzufügen, die mit Ihrer Office-Lösung bereitgestellt werden. Informationen zum Installieren der primären Interopassemblys finden Sie unter Konfigurieren eines Computers zum Entwickeln von Office-Lösungen und Vorgehensweise: Installieren primärer Interopassemblys von Office.
Die Veröffentlichung mithilfe von Localhost kann Installationsprobleme verursachen
Wenn Sie als Veröffentlichungs- oder Installationsspeicherort für Lösungen auf Dokumentebene verwenden http://localhost , konvertiert der Veröffentlichungs-Assistent die Zeichenfolge nicht in den tatsächlichen Computernamen. In diesem Fall muss die Lösung auf dem Entwicklungscomputer installiert werden. Damit bereitgestellte Lösungen IIS auf dem Entwicklungscomputer verwenden, verwenden Sie den vollqualifizierten Namen für alle HTTP/HTTPS/FTP-Speicherorte anstelle von localhost.
Zwischengespeicherte Assemblys werden anstelle aktualisierter Assemblys geladen.
Fusion, das .NET Framework Assemblyladeprogramm, lädt die zwischengespeicherte Kopie von Assemblys, wenn sich der Projektausgabepfad auf einer Netzwerkdateifreigabe befindet, die Assembly mit einem starken Namen signiert ist und sich die Assemblyversion der Anpassung nicht ändert. Wenn Sie eine Assembly aktualisieren, die diese Bedingungen erfüllt, wird das Update beim nächsten Ausführen des Projekts nicht angezeigt, da die zwischengespeicherte Kopie geladen wird.
Sie können Visual Studio so konfigurieren, dass Fusion bei jeder Projektausführung Assemblys herunter lädt.
Herunterladen von Assemblys anstelle des Ladens zwischengespeicherter Kopien
- Wählen Sie auf der Menüleiste Projekt, <ProjektName> Eigenschaften aus.
- Wählen Sie auf der Seite Anwendungdie Option Assemblyinformationen aus.
- Legen Sie die Revisionsnummer (drittes Feld) der Assemblyversion auf einen wilden Karte (*) fest. Beispiel: "1.0.*". Wählen Sie dann die Schaltfläche OK aus.
Nachdem Sie die Assemblyversion geändert haben, können Sie ihre Assembly weiterhin mit einem starken Namen signieren, und Fusion lädt die neueste Version der Anpassung.
Hinweis
Ab Visual Studio 2017 tritt beim Verwenden von Wildcards in der Assemblyversion ein Buildfehler auf. Dies liegt daran, dass Mit Wildcards in der Assemblyversion das MSBuild-Feature deterministisch unterbrochen wird. Sie werden angewiesen, entweder die Wildcards aus der Assemblyversion zu entfernen oder Determinismus zu deaktivieren. Weitere Informationen zum Deterministischen Feature finden Sie unter Allgemeine MSBuild-Projekteigenschaften und Anpassen ihres Builds.
Bei der Installation tritt ein Fehler auf, wenn der URI Zeichen enthält, die nicht US-ASCII sind.
Wenn Sie eine Office-Lösung an einem HTTP/HTTPS/FTP-Speicherort veröffentlichen, darf der Pfad keine Unicode-Zeichen enthalten, die nicht in US-ASCII enthalten sind. Solche Zeichen können zu inkonsistentem Verhalten im Setupprogramm führen. Verwenden Sie US-ASCII-Zeichen als Installationspfad.
Aufforderung zur manuellen Deinstallation wird angezeigt, wenn Sie eine Lösung auf dem Entwicklungscomputer veröffentlichen und installieren
Wenn Sie eine Office-Lösung erstellen, wird die erstellte Version automatisch registriert. Wenn Sie zuvor dieselbe Lösung auf Ihrem Entwicklungscomputer veröffentlicht und installiert haben, erkennt Visual Studio-Tools für Office Runtime, dass sich der Installationspfad für die veröffentlichte Version und die erstellte Version unterscheiden, nachdem die Lösung als nächstes erstellt, neu erstellt oder veröffentlicht wurde. Die Fehlermeldung besagt, dass die Anpassung nicht installiert werden kann, da derzeit eine andere Version installiert ist und von diesem Speicherort aus nicht aktualisiert werden kann. Die Registrierungsschlüssel werden aktualisiert, wenn eine Lösung neu erstellt wird. Daher müssen Sie die vorherige Version deinstallieren, bevor Sie die neue Version veröffentlichen, debuggen oder ausführen.
Um zu verhindern, dass die Nachricht angezeigt wird, erstellen Sie ein weiteres Benutzerkonto auf Ihrem Entwicklungscomputer, um Ihre Bereitstellung zu testen. Alternativ können Sie die Version aus der Liste der auf dem Computer installierten Programme deinstallieren, bevor Sie die Projektmappe veröffentlichen, debuggen oder neu erstellen.
Fehler "Nicht abgefangene Ausnahme oder Methode nicht gefunden" beim Installieren einer Lösung
Wenn Sie Office-Projektmappen durch Öffnen des Bereitstellungsmanifests (einer VSTO-Datei ), einer Office-Anwendung, eines Dokuments oder einer Arbeitsmappe installieren, werden möglicherweise Fehlermeldungen für die folgenden Bedingungen angezeigt:
- Methode nicht gefunden.
- Missingmethodexception.
- Nicht abgefangene Ausnahme.
Um diese Fehlermeldungen zu verhindern, installieren Sie die Lösung, indem Sie das Setupprogramm ausführen.
Wenn Sie die Lösung installieren, ohne das Setupprogramm auszuführen, überprüft oder installiert das Installationsprogramm nicht die erforderlichen Komponenten. Das Setupprogramm sucht nach der richtigen Version der erforderlichen Komponenten und installiert sie bei Bedarf.
Manifestregistrierungsschlüssel für Add-Ins ändern sich, nachdem ein InstallShield Limited Edition-Projekt erstellt wurde
Der Manifestregistrierungsschlüssel, der Teil eines VSTO-Add-In-Setupprogramms ist, ändert sich manchmal von .vsto in .dll.manifest , wenn Sie ein InstallShield Limited Edition-Projekt erstellen.
Um dieses Problem zu umgehen, erstellen Sie das Projekt InstallShield Limited Edition in einer anderen Projektmappe, oder verwenden Sie CompanyName.AddinName als Wert des Registrierungsschlüssels, der den Namen des VSTO-Add-Ins enthält.
Der ClickOnce-Installer für Ihre Office-Lösung installiert die primären Interopassemblys nicht.
Wenn Sie das Setupprogramm ausführen, das ClickOnce für Ihre Office-Projektmappe erstellt, wird das Installationsprogramm für die primären Interopassemblys (PIAs) von Office nur ausgeführt, wenn bereits keine PIAs installiert sind.
Wenn das Setupprogramm die PIAs nicht ordnungsgemäß installiert, installieren Sie sie manuell, indem Sie die Installationsdatei mit dem Namen o2007pia.msi aus dem Installationsverzeichnis ausführen.
Erneutes Installieren von Office-Projektmappen führt zu einer Ausnahme außerhalb des Bereichs eines Arguments
Wenn Sie eine Office-Projektmappe neu installieren, wird möglicherweise eine ArgumentOutOfRangeException Ausnahme mit der folgenden Fehlermeldung angezeigt: Das angegebene Argument lag außerhalb des Gültigen Wertebereichs.
Diese Situation tritt auf, wenn die Groß-/Kleinschreibung für die URL für den Installationsspeicherort anders ist. Dieser Fehler wird beispielsweise angezeigt, wenn Sie eine Office-Projektmappe beim http://fabrikam.com/ExcelSolution.vsto ersten Mal installiert und dann das zweite Mal verwendet haben http://fabrikam.com/excelsolution.vsto .
Um zu verhindern, dass die Nachricht angezeigt wird, verwenden Sie die gleiche Groß-/Kleinschreibung, wenn Sie Office-Projektmappen installieren.
Eine ClickOnce-Lösung kann nicht durch Öffnen des Bereitstellungsmanifests aus dem Web installiert werden
Benutzer können Office-Projektmappen installieren, indem sie das Bereitstellungsmanifest aus dem Web öffnen. Einige Installationen von Internetinformationsdienste (IIS) blockieren jedoch die VSTO-Dateinamenerweiterung . Sie müssen den MIME-Typ in IIS definieren, bevor Sie ihn zum Bereitstellen einer Office-Lösung verwenden.
Informationen zum Definieren des MIME-Typs in IIS 7 finden Sie unter Hinzufügen eines MIME-Typs (IIS7).
Legen Sie die Erweiterung auf .vsto und den MIME-Typ auf application/x-ms-vsto fest.