Problembehandlung bei der Office-Projektmappenbereitstellung (2007 System)
Aktualisiert: Juli 2008
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office. Projekttyp
Microsoft Office-Version
Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Dieser Abschnitt enthält Tipps zur Lösung von allgemeinen Problemen, die beim Bereitstellen von Microsoft Office-Projektmappen mit Visual Studio Tools for Office auftreten können.
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
Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-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 2007 Microsoft Office System 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 Visual Studio Tools for Office-Projektmappe bereitgestellt werden. Weitere Informationen zum Installieren der primären Interopassemblys finden Sie unter Installieren von Visual Studio Tools for Office 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 Visual Studio Tools for Office-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 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 hierzu finden Sie unter XML-Schemas und Daten (Visual Studio Tools for Office).
Installationsfehler, wenn der URI andere Zeichen als US-ASCII beinhaltet
Wird eine Visual Studio Tools for 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 Visual Studio Tools for 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 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 mit Visual Studio 2008 Service Pack 1 (SP1) entwickelte Office-Projektmappen installieren, indem Sie das Bereitstellungsmanifest (eine VSTO-Datei), die Office-Anwendung, das Dokument oder die Arbeitsmappe öffnen, werden für die folgenden Bedingungen möglicherweise Fehlermeldungen angezeigt:
Methode wurde nicht gefunden.
MissingMethodException.
Nicht abgefangene Ausnahme.
Um diese Fehler zu vermeiden, installieren Sie die Projektmappe, indem Sie das Setupprogramm ausführen.
Für mit Visual Studio 2008 SP1 entwickelte Office-Projektmappen ist SP1 für die Laufzeit für Visual Studio Tools for Office 3.0 erforderlich. Das Setupprogramm sucht nach der entsprechenden Version der erforderlichen Komponenten (einschließlich von SP1 für die Laufzeit) und installiert diese gegebenenfalls. Wenn Sie jedoch die Projektmappe installieren, ohne das Setupprogramm auszuführen, werden die erforderlichen Komponenten vom Installationsprogramm nicht gesucht und installiert.
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.
Wenn Sie mit Visual Studio 2008 SP1 arbeiten, ist diese Problemumgehung nicht erforderlich.
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.
Siehe auch
Konzepte
Problembehandlung bei ClickOnce-Bereitstellungen
Bereitstellen von Office-Projektmappen (2007 System)
Referenz
Problembehandlung (Vorgehensweisen in Visual Studio Tools for Office)
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
|---|---|---|
|
Juli 2008 |
Informationen über Szenarios zur Fehlerbehebung hinzugefügt. |
SP1-Featureänderung. |