Registrierungseinträge für Add-Ins auf Anwendungsebene

Artikel
02/26/2013

Sie müssen einen bestimmten Satz von Registrierungseinträgen erstellen, wenn Sie Add-Ins bereitstellen, die mithilfe von Visual Studio 2012 erstellt werden.Diese Registrierungseinträge enthalten Informationen, mit denen die Microsoft Office-Anwendung das Add-In erkennt und lädt.

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

Beim Erstellen des Projekts erstellt Visual Studio diese Registrierungseinträge auf dem Entwicklungscomputer, sodass Sie das Add-In einfach ausführen und debuggen können.Wenn Sie das Add-In mithilfe von ClickOnce bereitstellen, werden die Registrierungseinträge automatisch auf dem Endbenutzercomputer erstellt.Wenn Sie Windows Installer verwenden, um das Add-In bereitzustellen, müssen Sie die InstallShield Limited- Editionsprojekt konfigurieren, die Registrierungseinträge auf dem Endbenutzercomputer zu erstellen.

Weitere Informationen zur Verwendung der Registrierungseinträge während des Ladevorgangs für Add-Ins finden Sie unter Architektur von Add-Ins auf Anwendungsebene.

Hinweis
In diesem Thema stellt der Text add-in ID eine eindeutige ID für das Add-In dar.Standardmäßig entspricht die ID dem Namen der Add-In-Assembly.

Registrieren von Add-Ins für den aktuellen Benutzer zur . alle Benutzer

Wenn ein Add-In installiert ist, kann es auf zwei Arten registriert werden:

Nur für den aktuellen Benutzer (d. h. nur für den Benutzer verfügbar, der bei Installation des Add-Ins auf dem Computer angemeldet ist)In diesem Fall werden die Registrierungseinträge unter HKEY_CURRENT_USER erstellt.
Für alle Benutzer (das heißt, jeder auf dem Computer angemeldete Benutzer kann das Add-In verwenden).In diesem Fall werden die Registrierungseinträge unter HKEY_LOCAL_MACHINE erstellt.

Alle Add-Ins, die Sie mit Visual Studio 2012 erstellen, können für den aktuellen Benutzer registriert werden.Add-Ins können für alle Benutzer jedoch nur in bestimmten Szenarios registriert werden.Diese Szenarien hängen von der Version von Microsoft Office auf dem Computer ab und davon, wie das Add-In bereitgestellt wurde.

Microsoft Office-Version

Microsoft Office 2010 and Microsoft Office 2013-Anwendungen können Add-Ins laden, die unter HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USER registriert sind.

Um Add-Ins zu laden, die unter HKEY_LOCAL_MACHINE registriert sind, muass auf dem Computer Updatepaket 976477 installiert sein.Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=184923.

Deployment Type

Wenn Sie ClickOnce verwenden, um ein Add-In bereitzustellen, kann das Add-In nur für den aktuellen Benutzer registriert werden.Dies liegt daran, dass ClickOnce nur das Erstellen von Schlüsseln unter HKEY_CURRENT_USER unterstützt.Wenn Sie ein Add-In für alle Benutzer auf einem Computers registrieren möchten, müssen Sie Windows Installer verwenden, um das Add-In bereitzustellen.Weitere Informationen zu diesen Bereitstellungstypen finden Sie unter Bereitstellen einer Office-Lösung mithilfe von ClickOnce und Bereitstellen einer Office-Lösung mithilfe von Windows Installer.

Registrierungseinträge

Die erforderlichen Add-In-Registrierungseinträge befinden sich unter folgendem Registrierungsschlüssel für alle Anwendungen mit Ausnahme von Visio, wo Root HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE ist.

Stammverzeichnis\Software\Microsoft\Office\Anwendungsname\Addins\Add-In-ID

Für Visio befinden sich die Registrierungseinträge unter dem folgenden Registrierungsschlüssel.

Root\Software\Microsoft\Visio\Addins\add-in ID

In der folgenden Tabelle werden die Einträge in diesem Registrierungsschlüssel aufgeführt.

Eintrag	Typ	Wert
Description	REG_SZ	Erforderlich.Eine kurze Beschreibung des Add-Ins. Diese Beschreibung wird angezeigt, wenn der Benutzer das Add-In in der Microsoft Office-Anwendung im Dialogfeld Optionen im Bereich Add-Ins auswählt.
FriendlyName	REG_SZ	Erforderlich.Ein beschreibender Name des Add-Ins, der in der Microsoft Office-Anwendung im Dialogfeld COM-Add-Ins angezeigt wird.Der Standardwert ist die ID des Add-Ins.
LoadBehavior	REG_DWORD	Erforderlich.Ein Wert, der außer dem aktuellen Zustand des Add-Ins (geladen oder entladen) angibt, wann die Anwendung das Add-In laden soll. Standardmäßig ist dieser Wert auf 3 festgelegt, was bedeutet, dass das Add-In beim Start geladen wird.Weitere Informationen finden Sie unter LoadBehavior-Werte.
Manifest	REG_SZ	Erforderlich.Der vollständige Pfad des Bereitstellungsmanifests für das Add-In.Bei dem Pfad kann es sich um einen Speicherort auf dem lokalen Computer, eine Netzwerkfreigabe (UNC) oder um einen Webserver (HTTP) handeln. Wenn Sie Windows Installer verwenden, um die Projektmappe bereitzustellen, müssen Sie das Präfix file:/// dem Manifest-Pfad hinzufügen.Sie müssen die Zeichenfolge \|vstolocal auch anfügen (das heißt, das Pipezeichen\|gefolgt von vstolocal) am Ende dieses Pfads.Dadurch wird sichergestellt, dass die Projektmappe aus dem Installationsordner geladen wird und nicht aus dem ClickOnce-Cache.Weitere Informationen finden Sie unter Bereitstellen einer Office-Lösung mithilfe von Windows Installer. Hinweis Wenn Sie ein Add-In auf dem Entwicklungscomputer erstellen, fügt Visual Studio automatisch die \|vstolocal-Zeichenfolge an diesen Registrierungseintrag an.
Warmup	REG_DWORD	Dies ist optional.Ein Wert, der angibt, dass die .NET Framework- und Visual Studio-Tools für Office-Laufzeit-Last vor einem Add-In geladen werden und die wahrgenommene Zeit zum Laden eines Add-Ins reduzieren.Legen Sie den Warmup Eintrag auf 1 fest, und verwenden Sie diesen in Verbindung mit dem LoadBehavior Eintrag, um die Ladezeit für Outlook 2010 und Outlook 2013 Add-Ins zu reduzieren, die bereitgestellt werden, mit dem Windows Installer (MSI) verwendet.Dieser Registrierungsschlüssel kann nicht mithilfe von ClickOnce festgelegt werden.

Registrierungseinträge für Outlook-Formularbereiche

Wenn Sie einen benutzerdefinierten Formularbereich in einem Add-In für Outlook erstellen, werden zusätzliche Registrierungseinträge verwendet, um den Formularbereich für Outlook zu registrieren.Diese Einträge werden unter einem anderen Registrierungsschlüssel für jede Nachrichtenklasse erstellt, die vom Formularbereich unterstützt wird.Diese Registrierungsschlüssel befinden sich am folgenden Speicherort, wobei Root HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE ist.

Stammverzeichnis\Software\Microsoft\Office\Outlook\FormRegions\Nachrichtenklasse

Wie die anderen von allen Add-Ins verwendeten Registrierungseinträge erstellt Visual Studio beim Erstellen des Projekts die Formularbereich-Registrierungseinträge auf dem Entwicklungscomputer.Wenn Sie das Add-In mithilfe von ClickOnce bereitstellen, werden die Registrierungseinträge automatisch auf dem Endbenutzercomputer erstellt.Wenn Sie Windows Installer verwenden, um das Add-In bereitzustellen, müssen Sie die InstallShield Limited- Editionsprojekt konfigurieren, die Registrierungseinträge auf dem Endbenutzercomputer zu erstellen.

Weitere Informationen zu den Formularbereichsregistrierungseinträgen finden Sie unter Angeben von Formularbereichen in der Windows-Registrierung.Weitere Informationen zu Outlook-Formularbereichen finden Sie unter Erstellen von Outlook-Formularbereichen.

LoadBehavior-Werte

Der LoadBehavior-Eintrag unter dem Stamm\Software\Microsoft\Office\Anwendungsname\Addins\Add-In-ID-Schlüssel enthält eine bitweise Kombination von Werten, die das Laufzeitverhalten des Add-Ins angeben.Das Bit (Werte 0 und 1) der niedrigsten Ordnung gibt an, ob das Add-In gerade geladen ist.Andere Bits geben an, wann die Anwendung versucht, das Add-In zu laden.

In der Regel soll der LoadBehavior-Eintrag auf 0, 3 oder 16 (dezimal) festgelegt werden, wenn das Add-In auf Endbenutzercomputern installiert wird.Standardmäßig legt Visual Studio den LoadBehavior-Eintrag des Add-Ins auf 3 fest, wenn Sie es erstellen oder veröffentlichen.

In der folgenden Tabelle sind alle möglichen Werte für den LoadBehavior-Eintrag aufgeführt.Einige Beschreibungen in dieser Tabelle verweisen auf das manuelle oder programmgesteuerte Laden eines Add-Ins.Um ein Add-In manuell zu laden, aktivieren Sie das Kontrollkästchen neben dem Add-In im Dialogfeld COM Add-Ins in der Anwendung.Um ein Add-In programmgesteuert zu laden, legen Sie die Connect-Eigenschaft des COMAddIn-Objekts, das das Add-In darstellt, auf true fest.

Dezimalwert	Add-In-Status	Ladeverhalten des Add-Ins	Beschreibung
0	Unloaded	Nicht automatisch laden	Die Anwendung versucht nie, das Add-In beim Start automatisch zu laden.Der Benutzer kann das Add-In manuell laden, oder das Add-In kann programmgesteuert geladen werden. Wenn das Add-In erfolgreich geladen wird, bleibt der LoadBehavior-Wert 0, aber der Status des Add-Ins im Dialogfeld COM-Add-Ins wird aktualisiert, um anzugeben, dass das Add-In geladen wird.
1	Loaded	Nicht automatisch laden	Die Anwendung versucht nie, das Add-In beim Start automatisch zu laden.Der Benutzer kann das Add-In manuell laden, oder das Add-In kann programmgesteuert geladen werden. Obwohl das Dialogfeld COM-Add-Ins angibt, dass das Add-In geladen wird, nachdem die Anwendung gestartet hat, wird das Add-In eigentlich erst geladen, wenn es manuell oder programmgesteuert geladen wird. Wenn die Anwendung das Add-In erfolgreich lädt, ändert sich der LoadBehavior-Wert in 0 und bleibt nach dem Schließen der Anwendung weiterhin 0.
2	Unloaded	Bei Start laden	Die Anwendung versucht nicht, das Add-In beim Start automatisch zu laden.Der Benutzer kann das Add-In manuell laden, oder das Add-In kann programmgesteuert geladen werden. Wenn die Anwendung das Add-In erfolgreich lädt, ändert sich der LoadBehavior-Wert in 3 und bleibt nach dem Schließen der Anwendung weiterhin 3.
3	Loaded	Bei Start laden	Die Anwendung versucht, das Add-In beim Start zu laden.Dies ist der Standardwert, wenn Sie ein Add-In in Visual Studio erstellen oder veröffentlichen. Wenn die Anwendung das Add-In erfolgreich lädt, bleibt der LoadBehavior-Wert 3.Wenn beim Laden des Add-Ins ein Fehler auftritt, ändert sich der LoadBehavior-Wert in 2 und bleibt nach dem Schließen der Anwendung weiterhin 2.
8	Unloaded	Bei Bedarf laden	Die Anwendung versucht nicht, das Add-In beim Start automatisch zu laden.Der Benutzer kann das Add-In manuell laden, oder das Add-In kann programmgesteuert geladen werden. Wenn die Anwendung das Add-In erfolgreich lädt, ändert sich der LoadBehavior-Wert in 9.
9	Loaded	Bei Bedarf laden	Das Add-In wird nur geladen, wenn es für die Anwendung notwendig ist, z. B. wenn ein Benutzer auf ein Benutzeroberflächenelement klickt, das auf Funktionen im Add-In zurückgreift (z. B. eine benutzerdefinierte Schaltfläche im Menüband). Wenn die Anwendung das Add-In erfolgreich lädt, bleibt der LoadBehavior-Wert 9, aber der Status des Add-Ins im Dialogfeld COM-Add-Ins wird aktualisiert, um anzugeben, dass das Add-In momentan geladen ist.Wenn beim Laden des Add-Ins ein Fehler auftritt, ändert sich der LoadBehavior-Wert in 8.
16	Loaded	Beim ersten Mal laden, dann bei Bedarf laden	Legen Sie diesen Wert fest, wenn Sie das Add-In bei Bedarf laden möchten.Die Anwendung lädt das Add-In, wenn der Benutzer die Anwendung das erste Mal ausführt.Beim nächsten Ausführen lädt die Anwendung alle Benutzeroberflächenelemente, die durch das Add-In definiert werden, aber das Add-In wird erst dann geladen, wenn der Benutzer auf ein Benutzeroberflächenelement klickt, das dem Add-In zugeordnet ist. Wenn die Anwendung das Add-In zum ersten Mal erfolgreich lädt, bleibt der LoadBehavior-Wert 16, während das Add-In geladen wird.Nachdem die Anwendung geschlossen wurde, ändert sich der LoadBehavior-Wert in 9.