Übersicht über das Erstellen von Office-Projektmappen

  • Artikel

Aktualisiert: November 2007

Eine Microsoft Office-Projektmappe zu erstellen ähnelt sehr dem Erstellen anderer Anwendungen in Visual Studio. Es gibt jedoch mehrere Punkte zu berücksichtigen, die speziell für Office-Projektmappen gelten.

Allgemeine Informationen zum Erstellen von Anwendungen finden Sie unter Der Buildprozess in Visual Studio.

Projektausgabe für 2007 System-Projekte

Der Ausgabespeicherort für ein Projekt der Version 2007 ist projectname\bin\release oder projectname\bin\debug. Sie können ein Projekt nicht in einem Bereitstellungsverzeichnis erstellen.

Projekte auf Dokumentebene

Beim Erstellen eines Projekts auf Dokumentebene sind folgende Elemente in der Projektausgabe enthalten:

Projekte auf Anwendungsebene

Beim Erstellen eines Projekts auf Anwendungsebene sind folgende Elemente in der Projektausgabe enthalten:

Beim Buildprozess für Projekte auf Anwendungsebene wird zusätzlich ein Satz von Registrierungseinträgen auf dem Entwicklungscomputer erstellt, die zum Laden des Add-Ins notwendig sind. Weitere Informationen hierzu finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

Wenn Sie ein Outlook-Add-In-Projekt erstellen, das Formularbereiche enthält, werden im Buildprozess die folgenden zusätzlichen Informationen zur Registrierung hinzugefügt:

  • Ein Schlüssel für jede Nachrichtenklasse, die einem oder mehreren Formularbereichen zugeordnet ist.

  • Ein Eintrag für jeden Formularbereich und ein zugeordneter Wert, der den Namen des Outlook-Add-Ins darstellt.

Outlook benötigt diese Informationen zum Laden der Formularbereiche.

Projektausgabe für 2003 System-Projekte

Der Ausgabespeicherort für ein Projekt der Version 2003 ist projectname\bin\release oder projectname\bin\debug. Sie können ein Projekt nicht in einem Bereitstellungsverzeichnis erstellen.

Projekte auf Dokumentebene

Beim Erstellen eines Projekts auf Dokumentebene sind folgende Elemente in der Projektausgabe enthalten:

  • Eine Kopie des Projektdokuments.

  • Die Projektassembly sowie alle Assemblys, auf die verwiesen wird und deren Copy Local-Eigenschaft auf true festgelegt ist.

  • Das Anwendungsmanifest (eingebettet im Dokument). Weitere Informationen finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen.

  • Eine Programmdatenbankdatei (PDB-Datei).

Bei Excel-Projektmappen können Sie den Ausgabepfad oder das Arbeitsverzeichnis nicht ändern. Wenn Sie im Bereich Debuggen des Projekt-Designers für das Arbeitsverzeichnis einen anderen Speicherort festlegen, wird er von Excel zur Laufzeit, wenn das Dokument geöffnet wird, wieder in den Standardspeicherort geändert. Bei Word-Projektmappen hingegen können Sie den Ausgabepfad normal ändern.

Projekte auf Anwendungsebene

Beim Erstellen eines Projekts auf Anwendungsebene sind folgende Elemente in der Projektausgabe enthalten:

Beim Buildprozess für Projekte auf Anwendungsebene wird zusätzlich ein Satz von Registrierungseinträgen auf dem Entwicklungscomputer erstellt, die zum Laden des Add-Ins notwendig sind. Weitere Informationen hierzu finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

Assemblys, auf die verwiesen wird

Sie können in Ihrem Visual Studio Tools for Office-Projekt auf Assemblys (einschließlich Klassenbibliotheksprojekte) verweisen. Jede Assembly, auf die verwiesen wird, weist eine Eigenschaft mit dem Namen Copy Local (Lokale Kopie) auf. Copy Local gibt an, ob die Assembly ins Ausgabeverzeichnis kopiert wird. In der Standardeinstellung ist die Eigenschaft auf true festgelegt. Jede Assembly, auf die verwiesen wird, deren Copy Local-Eigenschaft auf true festgelegt ist, wird in das Ausgabeverzeichnis kopiert.

Sicherheit beim Buildprozess

Visual Studio konfiguriert automatisch die Sicherheitseinstellungen auf dem Entwicklungscomputer, um der Projektmappe während des Buildprozesses Vertrauenswürdigkeit zu gewähren. Dies lässt die Ausführung der Projektmappe zu, während Sie sie debuggen. Die Sicherheitskonfiguration wird für die unterschiedlichen Office-Versionen unterschiedlich gehandhabt.

2007 System-Projekte

Für Projekte in 2007 Microsoft Office System verwendet Visual Studio Tools for Office eine Aufnahmeliste und Zertifikate, um den Herausgeber zu überprüfen. Visual Studio erstellt automatisch ein temporäres Zertifikat zur Identifizierung von Office-Projektmappen und fügt einen Eintrag zur Aufnahmeliste hinzu, um diesem Zertifikat Vertrauenswürdigkeit zu gewähren.

Weitere Informationen finden Sie unter Sicherheit in Office-Projektmappen (2007 System).

2003 System-Projekte

Für Microsoft Office 2003-Projekte enthält Visual Studio Tools for Office eine boolesche Eigenschaft mit dem Namen Vertrauenswürdiger Assemblyspeicherort. Diese Eigenschaft wird im Eigenschaftenfenster in Visual Studio angezeigt. In der Standardeinstellung ist diese Eigenschaft auf True festgelegt. Wenn die Eigenschaft auf True festgelegt ist, gewährt Visual Studio beim Erstellen des Projekts der Projektassembly vollständige Vertrauenswürdigkeit, indem die URL als Beweis verwendet wird.

Berechtigungen für volle Vertrauenswürdigkeit werden auch Assemblys, auf die verwiesen wird, und Satellitenassemblys im Ausgabeordner gewährt. Vertrauenswürdigkeit wird auf Benutzerebene für Assemblys gewährt, die sich auf dem lokalen Computer befinden. Deshalb benötigen Sie keine Administratorrechte für diese Projekte. Wenn Sie das Projekt an einem anderen Speicherort neu erstellen, werden die Berechtigungen mit vollständiger Vertrauenswürdigkeit für den alten Speicherort entfernt. Weitere Informationen zur Sicherheit finden Sie unter Sicherheitsanforderungen für die Ausführung von Office-Projektmappen (2003 System).

Durch das Prüfen des Speicherorts und das Gewähren von Vertrauenswürdigkeit bei jedem Build können Sie Projekte verschieben und freigeben, ohne jedes Mal die Sicherheitskonfiguration des Computers manuell ändern zu müssen. Sie müssen allerdings den Projektspeicherort mit den von Visual Studio bereitgestellten Tools ändern. Wenn Sie ein externes Tool wie etwa Windows Explorer verwenden, kann Visual Studio die Berechtigungen nicht aktualisieren.

Netzwerkprojekte

Wenn sich der Speicherort der Assembly oder des Dokuments in einer Netzwerkfreigabe befindet, reicht die lokale Aktualisierung der Sicherheitsrichtlinie (auf Benutzerebene) nicht aus, damit die Projektmappe ausgeführt werden kann. Zu ihrer Ausführung muss ein Administrator den Assemblys und Dokumenten in der Netzwerkfreigabe auf der Computerebene vollständige Vertrauenswürdigkeit gewähren. Weitere Informationen über das Festlegen der Sicherheitsrichtlinie finden Sie unter Gewusst wie: Gewähren von Berechtigungen für Ordner und Assemblys (2003 System).

Für 2007 System-Projekte auf Dokumentebene müssen Sie außerdem den vollqualifizierten Speicherort des Dokuments zur Liste der vertrauenswürdigen Office-Ordner hinzufügen. Weitere Informationen finden Sie unter Gewähren von Vertrauenswürdigkeit für Dokumente (2007 System).

Testen einer Anpassung auf Dokumentebene

Drücken Sie F5, um eine Projektmappe zu erstellen und zu debuggen. Wenn Sie eine Word 2003- oder eine Word 2007-Projektmappe ohne Debuggen testen möchten, indem Sie das Dokument erstellen und dann außerhalb von Visual Studio öffnen, müssen Sie das Projekt schließen, ehe Sie das Dokument öffnen. Wenn Sie ein Word-Dokument in Visual Studio öffnen, wird für den Word-Prozess ein Flag festgelegt, damit keine Anpassungen ausgeführt werden. Wenn Sie ein angepasstes Word-Dokument außerhalb von Visual Studio öffnen, indem Sie in Windows Explorer auf die Datei doppelklicken, kann das Flag ebenfalls verhindern, dass das Dokument Anpassungen ausführt. Wenn Sie zum Öffnen auf die Datei doppelklicken, öffnet Word das Dokument im gleichen Prozess wie alle aktuell ausgeführten Dokumente. Da ein Dokument in Visual Studio geöffnet ist, wird das neue Dokument im gleichen Prozess geöffnet und erhält das Flag, das festlegt, dass keine Anpassungen ausgeführt werden sollen.

Testen eines Add-Ins auf Anwendungsebene

Drücken Sie F5, um eine Projektmappe zu erstellen und zu debuggen. Wenn Sie das Add-In auf Anwendungsebene durch Veröffentlichen und Installieren der Projektmappe testen, deinstallieren Sie die Projektmappe, bevor Sie sie erneut veröffentlichen oder weitere Codeänderungen vornehmen und sie durch Drücken von F5 erneut testen. Wenn Sie eine veröffentlichte Projektmappe installieren, wird die Assembly für das Add-In in den ClickOnce-Cache installiert. Das Setupprogramm erstellt außerdem Registrierungsschlüssel, damit die Office-Anwendung die Assembly suchen und laden 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 oder ausgeführt wird.

Verwenden des Befehls "Bereinigen"

Um die erstellten Projektdateien vom Entwicklungscomputer zu entfernen, verwenden Sie in Visual Studio im Menü Erstellen den Befehl Bereinigen. Der Befehl Bereinigen löscht alle Dateien im Buildausgabeverzeichnis. Bei Projekten auf Anwendungsebene werden durch den Befehl Bereinigen auch die vom Buildprozess erstellten Registrierungseinträge entfernt.

Hinweis:

Berechtigungen, die den Projektmappenassemblys während des Buildprozesses gewährt wurden, werden mit dem Befehl Bereinigen nicht entfernt. Informationen zur Entfernung von Berechtigungen finden Sie unter Gewusst wie: Entfernen von Berechtigungen für Ordner und Assemblys (2003 System).

Ändern des Plattformziels in x64

Standardmäßig ist das Plattformziel Any CPU. Wenn Sie das Plattformziel auf x64 festlegen, können Sie das Projekt kompilieren, aber die Projektmappe kann nicht ausgeführt werden. Für das Plattformziel x64 muss die Projektmappe in einem 64-Bit-Prozess ausgeführt werden. Office wird in einem 32-Bit-Prozess ausgeführt. Deshalb ist Office nicht in der Lage, die Projektmappe zu laden.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Office-Projektmappen

Konzepte

Debuggen in Projekten auf Dokumentebene

Weitere Ressourcen

Erstellen und Debuggen von Office-Projektmappen

Der Buildprozess in Visual Studio