Exemplarische Vorgehensweise: Bereitstellen eines Dokuments und einer Assembly in einem lokalen Ordner (2003 System)

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version Microsoft Office 2003 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office.

Projekttyp

Projekte auf Dokumentebene

Microsoft Office-Version

Microsoft Office 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Diese exemplarische Vorgehensweise veranschaulicht, wie eine Anpassung auf Dokumentebene in einem neuen Ordner auf dem Entwicklungscomputer bereitgestellt wird, sodass sich das Dokument und die Assembly in demselben Ordner befinden. Dieser Typ von Bereitstellung wird als Bereitstellungsmodell Lokal/Lokal bezeichnet.

Weitere Informationen über die Optionen zum Bereitstellen einer Projektmappe finden Sie unter Bereitstellungsmodelle (2003 System). Weitere Informationen zu Anpassungen auf Dokumentebene finden Sie unter Architektur von Anpassungen auf Dokumentebene.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Gewähren voller Vertrauenswürdigkeit für eine Projektmappenassembly von Visual Studio Tools for Office, die sich in einem lokalen Ordner befindet.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

Microsoft Office Word 2003 oder Microsoft Office Excel 2003.

Hinweis:
In dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass Sie eine Word-Projektmappe bereitstellen. Wenn Sie die exemplarische Vorgehensweise mit einer Excel-Projektmappe durchführen möchten, müssen Sie in allen Codebeispielen den Namen des Word-Projekts durch den Namen des Excel-Projekts ersetzen.

Administratorrechte auf dem Entwicklungscomputer, damit Sie die Sicherheitsrichtlinien festlegen können.

Erstellen einer Projektmappe für die Bereitstellung

Erstellen Sie als ersten Schritt eine grundlegende Visual Studio Tools for Office-Projektmappe für die Bereitstellung. Wenn Sie bereits über eine Projektmappe verfügen, die Sie bereitstellen möchten, können Sie diesen Abschnitt überspringen und mit "Bereitstellen der Projektmappe" fortfahren.

So erstellen Sie eine Projektmappe für die Bereitstellung

Erstellen Sie ein Word-Dokumentprojekt mit dem Namen WordDeployment unter Verwendung der Projektvorlage für Office 2003.

Wählen Sie im Assistenten Neues Dokument erstellen aus. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen von Visual Studio Tools for Office-Projekte.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei ThisDocument, und klicken Sie danach auf Code anzeigen.
Fügen Sie im ThisDocument_Startup-Ereignishandler folgenden Code hinzu. Mit diesem Code wird beim Öffnen des Dokuments eine Meldung angezeigt, mit der ganz einfach überprüft werden kann, ob die Projektmappe erfolgreich bereitgestellt wurde.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Weitere Informationen zum Startup-Ereignis finden Sie unter Visual Studio Tools for Office-Projektereignisse.
Drücken Sie F5, um das Projekt zu erstellen und auszuführen. Vergewissern Sie sich, dass die Meldung angezeigt wird.

Bereitstellen der Projektmappe

Sie können jetzt das Dokument und die Assembly in einem neuen Ordner auf dem Entwicklungscomputer bereitstellen.

So stellen Sie die Projektmappe bereit

Erstellen Sie im Stammverzeichnis des Windows-Systemlaufwerks (%SystemDrive%) einen Ordner mit dem Namen TestDeploy. Wenn das Systemlaufwerk z. B. C ist, lautet das Verzeichnis C:\TestDeploy.
Kopieren Sie das Dokument und die Assembly aus dem Buildausgabeordner (normalerweise project folder\bin\debug oder project folder\bin\release) in den Ordner %SystemDrive%\TestDeploy.
Öffnen Sie das Dokument im Ordner %SystemDrive%\TestDeploy. Es wird eine Fehlermeldung angezeigt, die angibt, dass die aktuelle .NET-Sicherheitsrichtlinie die Ausführung der Anpassung nicht zulässt. Dies liegt daran, dass Sie der Assembly keine volle Vertrauenswürdigkeit gewährt haben.
Klicken Sie auf OK, und schließen Sie dann das Dokument.

Festlegen der Sicherheitsrichtlinie

Bevor Sie die Projektmappe ausführen können, müssen Sie der Assembly in der .NET Framework 2.0-Sicherheitsrichtlinie volle Vertrauenswürdigkeit gewähren. In dieser exemplarischen Vorgehensweise wird das Sicherheitsrichtlinientool für den Codezugriff (Caspol.exe) verwendet, um der Assembly volle Vertrauenswürdigkeit zu gewähren.

Weitere Informationen über die Verwendung von Caspol.exe finden Sie unter Sicherheitsrichtlinientool für den Codezugriff (Caspol.exe) und Konfigurieren der Sicherheitsrichtlinien mit dem Sicherheitsrichtlinientool für den Codezugriff (Caspol.exe).

Sicherheitshinweis:
Für den Zweck dieser exemplarischen Vorgehensweise sind dies die grundlegenden Schritte zum Festlegen einer Sicherheitsrichtlinie auf der Grundlage eines URL-Beweises. Assemblys in einer realen Projektmappe sollten Sie auf diese Weise nur Vertrauenswürdigkeit gewähren, wenn Sie genau wissen, dass der Speicherort sicher ist. Die Sicherheit einer realen Projektmappe sollte zudem von umfassenderen Beweisen als der URL der Assembly abhängig gemacht werden. Weitere Informationen hierzu finden Sie unter Sicherheitsanforderungen für die Ausführung von Office-Projektmappen (2003 System).

Für den Zweck dieser exemplarischen Vorgehensweise sind dies die grundlegenden Schritte zum Festlegen einer Sicherheitsrichtlinie auf der Grundlage eines URL-Beweises. Assemblys in einer realen Projektmappe sollten Sie auf diese Weise nur Vertrauenswürdigkeit gewähren, wenn Sie genau wissen, dass der Speicherort sicher ist. Die Sicherheit einer realen Projektmappe sollte zudem von umfassenderen Beweisen als der URL der Assembly abhängig gemacht werden. Weitere Informationen hierzu finden Sie unter Sicherheitsanforderungen für die Ausführung von Office-Projektmappen (2003 System).

So gewähren Sie der Assembly volle Vertrauenswürdigkeit

Geben Sie in der Eingabeaufforderung den folgenden Befehl ein, um eine neue Codegruppe zu erstellen, die der Assembly volle Vertrauenswürdigkeit gewährt. Ersetzen Sie full assembly path durch den vollständigen Pfad der Assembly auf dem Entwicklungscomputer, z. B. durch C:\TestDeploy\WordDeployment.dll.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
Der -n-Parameter gibt einen Namen für die neue Codegruppe an. Dieser Parameter ist nicht erforderlich, die neue Codegruppe kann jedoch anhand einer Bezeichnung später leichter identifiziert und entfernt werden, nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben.
Geben Sie yes ein, wenn Sie aufgefordert werden, die Ausführung des Vorgangs zu bestätigen, und drücken Sie die EINGABETASTE.
Öffnen Sie das Dokument im Ordner %SystemDrive%\TestDeploy, und vergewissern Sie sich, dass die Meldung angezeigt wird.
Klicken Sie auf OK, und schließen Sie dann das Dokument.

Nächste Schritte

Sie können das Dokument und die Assembly auch in unterschiedlichen Ordnern auf demselben Computer bereitstellen, oder Sie können das Dokument und die Assembly in einem Netzwerkordner bereitstellen. Weitere Informationen finden Sie in den folgenden exemplarischen Vorgehensweisen: