Bewährte Entwicklungsmethoden für COM, VSTO und VBA-Add-Ins in Office

Wenn Sie COM-, VSTO- oder VBA-Add-Ins für Office entwickeln, befolgen Sie die in diesem Artikel beschriebenen bewährten Methoden für die Entwicklung. Vorteile:

• Kompatibilität Ihrer Add-Ins in verschiedenen Versionen und Bereitstellungen von Office.
• Verringerte Komplexität der Add-In-Bereitstellung für Ihre Benutzer und IT-Administratoren.
• Unbeabsichtigte Installation oder Laufzeitfehler Ihres Add-Ins treten nicht auf.

Hinweis: Die Verwendung der Desktop-Brücke zum Vorbereiten Ihres COM-, VSTO- oder VBA-Add-Ins für den Windows Store wird nicht unterstützt. COM-, VSTO- und VBA-Add-Ins können nicht im Windows Store oder im Office Store verteilt werden.

Während der Installation nicht auf Office überprüfen

Es wird nicht empfohlen, dass Ihr Add-In erkennt, ob Office während des Add-In-Installationsprozesses installiert ist. Wenn Office nicht installiert ist, können Sie das Add-In installieren, und der Benutzer kann nach der Installation von Office darauf zugreifen.

Verwenden von eingebetteten Interoperabilitätstypen (NoPIA)

Wenn Ihre Lösung .NET 4.0 oder höher verwendet, verwenden Sie eingebettete Interoperabilitätstypen (NoPIA) anstelle der weiterverteilbaren Interopassemblys (PIA) von Office. Durch die Verwendung von Typeinbettungen wird die Installationsgröße Ihrer Lösung reduziert und die zukünftige Kompatibilität sichergestellt. Office 2010 war die letzte Version von Office, die die verteilbare PIA ausgeliefert hat. Weitere Informationen finden Sie unter Walkthrough: Embedding type information from Microsoft Office assemblies and Type equivalence and embedded interop types.

Wenn Ihre Lösung eine frühere Version von .NET verwendet, empfiehlt es sich, Ihre Lösung auf die Verwendung von .NET 4.0 oder höher zu aktualisieren. Die Verwendung von .NET 4.0 oder höher reduziert die Laufzeitvoraussetzungen für neuere Versionen von Windows.

Vermeiden sie je nach bestimmten Office-Versionen

Wenn Ihre Lösung Funktionen verwendet, die nur in neueren Versionen von Office verfügbar sind, überprüfen Sie, ob die Funktion (sofern möglich, auf Featureebene) zur Laufzeit vorhanden ist (z. B. mithilfe der Ausnahmebehandlung oder durch Überprüfen der Version). Überprüfen Sie mindestversionen anstelle bestimmter Versionen, indem Sie unterstützte APIs im Objektmodell verwenden, z. B. die Application.Version-Eigenschaft. Es wird nicht empfohlen, dass Sie office-Binärmetadaten, Installationspfade oder Registrierungsschlüssel verwenden, da diese sich zwischen Installationen, Umgebungen und Versionen ändern können.

Aktivieren der 32-Bit- und der 64-Bit-Office-Nutzung

Ihr Standardbuildziel sollte sowohl 32-Bit (x86) als auch 64-Bit (x64) unterstützen, es sei denn, Ihre Lösung hängt von Bibliotheken ab, die nur für eine bestimmte Bitanzahl verfügbar sind. Die 64-Bit-Version von Office nimmt an Akzeptanz zu, insbesondere in Big Data-Umgebungen. Durch die Unterstützung von 32-Bit- und 64-Bit-Versionen können Ihre Benutzer einfacher zwischen 32-Bit- und 64-Bit-Versionen von Office wechseln.

Verwenden Sie beim Schreiben von VBA-Code 64-Bit-Sichere Declare-Anweisungen, und konvertieren Sie Variablen entsprechend. Stellen Sie außerdem sicher, dass Dokumente zwischen Benutzern freigegeben werden können, die entweder 32-Bit- oder 64-Bit-Versionen von Office ausführen, indem Sie Code für jede Bitanzahl bereitstellen. Weitere Informationen finden Sie in der Übersicht über 64-Bit-Visual Basic für Anwendungen.

Unterstützung eingeschränkter Umgebungen

Ihre Lösung sollte keine Rechte zur Erhöhung des Benutzerkontos oder Administratorrechte erfordern. Darüber hinaus sollte die Lösung nicht von der Einstellung oder Änderung abhängen:

• Das aktuelle Arbeitsverzeichnis
• DLL-Ladeverzeichnisse.
• Die PATH-Variable.

Ändern des Speicherorts freigegebener Daten und Einstellungen

Wenn die Lösung aus einem Add-In und einem Prozess besteht, der sich außerhalb von Office befindet, verwenden Sie nicht den Anwendungsdatenordner des Benutzers oder die Registrierung, um Daten oder Einstellungen zwischen dem Add-In und dem externen Prozess auszutauschen. Erwägen Sie stattdessen die Verwendung des temporären Ordners, des Dokumentordners oder des Installationsverzeichnisses Ihrer Lösung.

Erhöhen der Versionsnummer bei jedem Update

Legen Sie die Versionsnummer der Binärdateien in Ihrer Lösung fest, und erhöhen Sie sie mit jedem Update. Dies erleichtert Benutzern die Identifizierung von Änderungen zwischen Versionen und die Bewertung der Kompatibilität.

Bereitstellen von Supportanweisungen für die neuesten Versionen von Office

Kunden bitten ISVs, Supportanweisungen für ihre COM-, VSTO- und VBA-Add-Ins bereitzustellen, die in Office ausgeführt werden. Wenn Sie Ihre expliziten Supportanweisungen auflisten, können Kunden, die Microsoft 365 Apps for Enterprise-Bereitschaftstools verwenden, Ihren Support verstehen.

Um Supportanweisungen für Office-Clientanwendungen (z. B. Word oder Excel) bereitzustellen, überprüfen Sie zuerst, ob Ihre Add-Ins in der aktuellen Office-Version ausgeführt werden, und stellen Sie dann einen Commit fest, um Updates bereitzustellen, wenn Ihr Add-In in einer zukünftigen Version unterbrochen wird. Sie müssen Ihre Add-Ins nicht testen, wenn Microsoft einen neuen Build oder ein Update auf Office veröffentlicht. Microsoft ändert selten die COM-, VSTO- und VBA-Erweiterbarkeitsplattform in Office, und diese Änderungen sind gut dokumentiert.

Wichtig: Microsoft Standard enthält eine Liste der unterstützten Add-Ins für Bereitschaftsberichte und ISV-Kontaktinformationen. Informationen zum Aufgelisteten Ihres Add-Ins finden Sie unter "/configmgr/desktop-analytics/ready-for-windows".

Verwenden der Prozessüberwachung zum Debuggen von Installations- oder Ladeproblemen

Wenn das Add-In während der Installation oder beim Laden Kompatibilitätsprobleme hat, sind sie möglicherweise mit Problemen mit dem Datei- oder Registrierungszugriff verbunden. Verwenden Sie den Prozessmonitor oder ein ähnliches Debuggingtool, um das Verhalten mit einer Arbeitsumgebung zu protokollieren und zu vergleichen, um das Problem zu identifizieren.