Problembehandlung bei der Office-Projektmappenbereitstellung

Artikel
08/10/2011

Dieser Abschnitt enthält Tipps zur Lösung von allgemeinen Problemen, die beim Bereitstellen von Office-Projektmappen auftreten können.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und Anwendungsebene für Microsoft Office 2010 und 2007 Microsoft Office System. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Problembehandlung für Office-Projektmappen mit der Ereignisanzeige

Beim Installieren oder Deinstallieren von Office-Lösungen werden von Visual Studio Tools for Office-Laufzeit Fehlermeldungen protokolliert, die Sie mit der Ereignisanzeige in Windows anzeigen können. 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.

Konflikte nach Änderung des Assemblynamens

Wird der Wert Assemblyname auf der Seite Anwendung von Projekt-Designer geändert, nachdem bereits eine Projektmappe bereitgestellt wurde, wird das Setup-Paket von Veröffentlichungstools so geändert, dass es eine Datei vom Typ Setup.exe und zwei Bereitstellungsmanifeste beinhaltet. Die Bereitstellung von zwei Manifestdateien kann folgende Auswirkungen nach sich ziehen:

Installiert der Endbenutzer beide Versionen, werden von der Anwendung beide Add-Ins geladen.
Wurde das Add-In vor Änderung des Assemblynamens installiert, empfängt der Endbenutzer niemals Updates.

Um dies zu verhindern, darf der Wert Assemblyname der Projektmappe nach deren Bereitstellung nicht geändert werden.

Die Suche nach Updates nimmt viel Zeit in Anspruch

Visual Studio 2010-Tools for Office-Laufzeit beinhaltet einen Registrierungseintrag, der Administratoren das Festlegen eines Timeoutwerts für das Herunterladen der Manifeste und der Projektmappe ermöglicht.

So legen Sie den Timeoutwert fest

Navigieren Sie in der Registrierung zu folgendem Schlüssel:

HKEY_CURRENT_USER\Software\Microsoft\VSTA
Legen Sie im Unterschlüssel AddInTimeout den Timeoutwert in Millisekunden fest.

Ist der Unterschlüssel AddInTimeout nicht vorhanden, erstellen Sie ihn als DWORD.

Aktualisieren oder Veröffentlichen auf einer Netzwerkdateifreigabe nicht möglich

Office-Projektmappen in einer Netzwerkdateifreigabe zeigen während Updates unter Umständen eine irreführende Meldung an, falls die Datei Setup.exe der Projektmappe bei Veröffentlichung des Updates in einem Prozess gesperrt ist. In der Meldung wird möglicherweise Folgendes angezeigt: "Die Datei 'setup.exe' konnte dem Web nicht hinzugefügt werden. Die Datei 'setup.exe' ist in diesem Web bereits vorhanden."

Eine Dateisperrung verhindern Sie dadurch, dass Sie die Freigabe Endbenutzern nur schreibgeschützt zur Verfügung stellen. Befinden sich Dokumente allerdings in der Freigabe, stehen sie Endbenutzern ebenfalls schreibgeschützt zur Verfügung.

Erforderliche Komponenten für Microsoft Office sind nicht installiert

Sie können dem Setup-Paket Microsoft .NET Framework, die Visual Studio Tools for Office-Laufzeit und die primären Interopassemblys von Microsoft Office als erforderliche Komponenten hinzufügen, die mit der Office-Projektmappe bereitgestellt werden. Weitere Informationen zum Installieren der primären Interopassemblys finden Sie unter Konfigurieren eines Computers zum Entwickeln von Office-Lösungen und Gewusst wie: Installieren von primären Interopassemblys für Office.

Veröffentlichungen mithilfe von 'Localhost' können zu Installationsproblemen führen

Bei Verwendung von "https://localhost" als Veröffentlichungs- oder Installationsort für Projektmappen auf Anwendungsebene konvertiert der Webpublishing-Assistent die Zeichenfolge nicht in den tatsächlichen Computernamen. Dies bedeutet, dass die Projektmappe nur auf dem Entwicklungscomputer installiert werden kann. Damit bereitgestellte Projektmappen auf dem Entwicklungscomputer Internetinformationsdienste verwenden, muss anstelle von localhost der vollqualifizierte Name für alle HTTP/HTTPS/FTP-Speicherorte verwendet werden.

Anstelle von aktualisierten Assemblys werden zwischengespeicherte Assemblys geladen

Fusion, das Assemblyladeprogramm von .NET Framework, lädt die zwischengespeicherte Kopie der Assemblys, wenn sich der Projektausgabepfad in einer Netzwerkdateifreigabe befindet, die Assembly mit einem starken Namen signiert ist und die Assemblyversion der Anpassung nicht geändert wird. Wird eine Assembly aktualisiert, die diese Bedingungen erfüllt, wird das Update erst bei der nächsten Ausführung des Projekts angezeigt, da die zwischengespeicherte Kopie geladen wird.

Visual Studio kann so konfiguriert werden, dass bei jeder Ausführung des Projekts Assemblys von Fusion heruntergeladen werden.

So laden Sie Assemblys herunter, anstatt zwischengespeicherte Kopien zu laden

Klicken Sie im Menü Projekt auf ProjectName-Eigenschaften.
Klicken Sie auf der Seite Anwendung auf Assemblyinformationen.
Geben Sie im Feld Assemblyversion ein Sternchen (*) ein.
Klicken Sie auf OK.

Nach dem Ändern der Assemblyversion kann die Signatur der Assembly mit einem starken Namen fortgesetzt werden, und die aktuelle Version der Anpassung wird geladen.

XML-Schemas in Anpassungen auf Dokumentebene werden nicht registriert

Wird einem Dokument in einem Projekt auf Dokumentebene für 2007 Microsoft Office System ein XML-Schema hinzugefügt, wird das Schema nicht in der Bibliothek des Benutzers registriert. Erstellen Sie zu diesem Zweck eine gesonderte Installationsdatei. Weitere Informationen finden Sie unter XML-Schemas und -Daten in Anpassungen auf Dokumentebene.

Installationsfehler, wenn der URI andere Zeichen als US-ASCII beinhaltet

Wird eine Office-Projektmappe in einem HTTP/HTTPS/FTP-Speicherort veröffentlicht, darf der Pfad keine Unicode-Zeichen enthalten, die nicht in US-ASCII vorliegen. Solche Zeichen können zu inkonsistentem Verhalten im Setup-Programm führen. Verwenden Sie für den Installationspfad US-ASCII-Zeichen.

Eingabeaufforderung zum manuellen Deinstallieren wird angezeigt, wenn Sie eine Projektmappe auf dem Entwicklungscomputer veröffentlichen und installieren

Wenn Sie eine Office-Projektmappe erstellen, wird die erstellte Version automatisch registriert. Wenn Sie dieselbe Projektmappe bereits auf dem Entwicklungscomputer veröffentlicht und installiert haben, erkennt Visual Studio Tools for Office-Laufzeit nach der nächsten Erstellung, erneuten Erstellung oder Veröffentlichung, dass der Installationspfad für die veröffentlichte Version und die erstellte Version unterschiedlich sind. Die Fehlermeldung lautet wie folgt: "Die Anpassung kann nicht installiert werden, weil derzeit eine andere Version installiert ist und von diesem Speicherort nicht aktualisiert werden kann." Da mit einer erneuten Erstellung der Projektmappe die Registrierungsschlüssel aktualisiert werden, ist es notwendig, die erste Version zu deinstallieren, bevor die zweite Version veröffentlicht, debuggt oder ausgeführt wird.

Um zu verhindern, dass diese Meldung angezeigt wird, erstellen Sie auf dem Entwicklungscomputer ein weiteres Benutzerkonto zum Testen der Bereitstellung. Sie können jedoch auch die Version aus der Liste der auf dem Computer installierten Programme entfernen, bevor Sie die Projektmappe wieder veröffentlichen, debuggen oder erneut erstellen.

Fehler mit nicht abgefangener Ausnahme oder nicht gefundener Methode beim Installieren einer Projektmappe

Wenn Sie Office-Projektmappen installieren, indem Sie das Bereitstellungsmanifest (eine VSTO-Datei), eine Office-Anwendung, ein Dokument oder eine Arbeitsmappe öffnen, werden möglicherweise Fehlermeldungen für die folgenden Bedingungen angezeigt:

Methode wurde nicht gefunden.
MissingMethodException.
Nicht abgefangene Ausnahme.

Um diese Fehler zu vermeiden, installieren Sie die Projektmappe, indem Sie das Setupprogramm ausführen.

Wenn Sie die Projektmappe installieren, ohne das Setupprogramm auszuführen, werden die erforderlichen Komponenten vom Installationsprogramm nicht überprüft oder installiert. Das Setupprogramm sucht nach der entsprechenden Version der erforderlichen Komponenten und installiert sie gegebenenfalls.

Geänderte Manifest-Registrierungsschlüssel für Add-Ins nach dem Erstellen eines Windows Installer-Setupprojekts

Der Manifest-Registrierungsschlüssel, der Teil eines Add-In-Setupprogramms ist, wird beim Erstellen des Windows Installer-Setupprojekts gelegentlich von .vsto in .dll.manifest geändert.

Um dieses Problem zu umgehen, müssen Sie das Setup-Projekt in einer anderen Projektmappe erstellen oder für den Registrierungsschlüssel, der den Namen des Add-Ins enthält, CompanyName.AddinName als Wert angeben.

Die primären Interopassemblys werden vom ClickOnce-Installationsprogramm für die Office-Projektmappe nicht installiert

Wenn Sie das Setupprogramm ausführen, das von ClickOnce für die Office-Projektmappe erstellt wird, wird das Installationsprogramm für die primären Interopassemblys von Office (PIAs) nur ausgeführt, wenn noch keine PIAs installiert sind.

Wenn die PIAs vom Setupprogramm nicht ordnungsgemäß installiert werden, installieren Sie diese manuell, indem Sie die Installationsdatei o2007pia.msi aus dem Installationsverzeichnis ausführen.

Neuinstallation von Office-Projektmappen löst eine Ausnahme (Argument außerhalb des gültigen Bereichs) aus

Wenn Sie eine Office-Projektmappe neu installieren, wird möglicherweise eine ArgumentOutOfRangeException-Ausnahme mit der Fehlermeldung "Das angegebene Argument liegt außerhalb des gültigen Wertebereichs" angezeigt.

Diese Ausnahme wird ausgelöst, wenn sich die Groß-/Kleinschreibung für die Installationspfad-URL unterscheidet. Dieser Fehler kann beispielsweise auftreten, wenn Sie eine Office-Projektmappe von https://fabrikam.com/ExcelSolution.vsto zum ersten Mal installieren und dann https://fabrikam.com/excelsolution.vsto zum zweiten Mal verwenden.

Sie können diesen Fehler vermeiden, indem Sie beim Installieren von Office-Projektmappen die gleiche Groß-/Kleinschreibung verwenden.

Freigeben über