Gewusst wie: Programmgesteuertes Aktualisieren von Pfaden für Anwendungsmanifestassemblys (2003 System)

Aktualisiert: November 2007

Mithilfe des Objektmodells in der Visual Studio Tools for Office-Laufzeit können Sie das in einem Dokument eingebettete Anwendungsmanifest, das Teil der Anpassung auf Dokumentebene ist, programmgesteuert aktualisieren.

Wenn Sie den Pfad zu den Assemblys ändern, müssen Sie ein neues Anwendungsmanifest erstellen und das Anwendungsmanifest mit den überholten Pfaden ersetzen. Sie können in den Pfaden zu den Assemblys Umgebungsvariablen wie %ProgramFiles% oder %UserProfile% verwenden.

Sie müssen den Code für die Änderung des Objektmodells in einem neuen Projekt (nicht in der Visual Studio Tools for Office-Projektmappe) einfügen, beispielsweise in einer Konsolenanwendung oder einem Windows Forms-Projekt. Visual Studio Tools for Office enthält ein Beispiel, das die Erstellung eines Tools zum Bearbeiten des eingebetteten Anwendungsmanifests veranschaulicht. Weitere Informationen hierzu finden Sie unter ServerDocument-Beispiel.

Es ist ein weiteres Modell für die Aktualisierung von Manifesten verfügbar, bei dem XML-Dateien auf einem Server geändert werden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Ändern des Speicherorts von Anpassungen auf Dokumentebene (2003 System).

Hinweis:

Dieses Thema hat für Add-Ins auf Anwendungsebene keine Bedeutung, da diese keine eingebetteten Anwendungsmanifeste verwenden. Um den Pfad einer Add-In-Assembly zu ändern, aktualisieren Sie das Anwendungsmanifest auf dem Clientcomputer mit einem Text-Editor. Weitere Informationen hierzu finden Sie unter Anwendungsmanifeste für Office-Projektmappen (2003 System). Weitere Informationen zu Add-Ins auf Anwendungsebene und Anpassungen auf Dokumentebene finden Sie unter Architektur von Anpassungen auf Dokumentebene.

So ändern Sie den Pfad zu den Assemblys programmgesteuert

1. Fügen Sie dem Projekt zur Änderung des Objektmodells einen Verweis auf Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 hinzu, falls dieser nicht bereits vorhanden ist.

2. Fügen Sie der Laufzeit am Anfang der Codedatei eine Imports-Anweisung oder eine using-Anweisung hinzu:

   Imports Microsoft.VisualStudio.Tools.Applications.Runtime
   

   using Microsoft.VisualStudio.Tools.Applications.Runtime;
   

3. Rufen Sie die statische AddCustomization-Methode der ServerDocument-Klasse auf, und übergeben Sie die erforderlichen Argumente. Sie sollten zuerst die RemoveCustomization-Methode aufrufen, um gegebenenfalls vorhandene Visual Studio Tools for Office-Anpassungen aus dem Dokument zu entfernen. Andernfalls wird von AddCustomization eine InvalidOperationException ausgelöst.

   Dim solutionDocument As String = "C:\Documents\ExcelApplication.xls"
   Dim assemblyName As String = "ExcelApplication.dll"
   Dim manifestPath As String = "\\serversame\deployshare\ExcelApplication.application"
   Dim applicationVersion As String = "1.0.0.1"
   
   If ServerDocument.IsCustomized(solutionDocument) Then
       ServerDocument.RemoveCustomization(solutionDocument)
   End If
   
   ServerDocument.AddCustomization( _
       solutionDocument, assemblyName, manifestPath, _
       applicationVersion, False)
   

   string solutionDocument = @"C:\Documents\ExcelApplication.xls";
   string assemblyName = "ExcelApplication.dll";
   string manifestPath = @"\\servername\deployshare\ExcelApplication.application";
   string applicationVersion = "1.0.0.1";
   
   if (ServerDocument.IsCustomized(solutionDocument))
   {
       ServerDocument.RemoveCustomization(solutionDocument);
   }
   
   ServerDocument.AddCustomization(
       solutionDocument, assemblyName, manifestPath, 
       applicationVersion, false);
   

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuertes Ändern des Pfads zum Bereitstellungsmanifest (2003 System)

Gewusst wie: Entfernen verwalteter Codeerweiterungen aus Dokumenten (2003 System)

Konzepte

Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen

Bereitstellen von Office-Projektmappen (2003 System)

Referenz

Anwendungsmanifeste für Office-Projektmappen (2003 System)

Bereitstellungsmanifeste für Office-Projektmappen (2003 System)