Partager via

Comment : mettre à jour par programme les chemins d'accès de l'assembly du manifeste d'application (Office System 2003)

  • Article

Mise à jour : novembre 2007

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets et versions Visual Studio Tools pour Office spécifiés de Microsoft Office.

Type de projet

  • Projets au niveau du document

Version de Microsoft Office

  • Microsoft Office 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Vous pouvez utiliser le modèle objet du runtime Visual Studio Tools pour Office pour mettre à jour par programme le manifeste d'application incorporé dans un document qui fait partie d'une personnalisation au niveau du document.

Lorsque vous modifiez les chemins d'accès aux assemblys, vous devez créer un manifeste d'application et remplacer celui qui contient les chemins d'accès obsolètes. Vous pouvez utiliser des variables d'environnement, telles que %ProgramFiles% ou %UserProfile%, dans les chemins d'accès aux assemblys.

Vous devez placer le code permettant de manipuler le modèle objet dans un nouveau projet (et non dans votre solution Visual Studio Tools pour Office), tel qu'une application console ou un projet Windows Forms. Visual Studio Tools pour Office inclut un exemple qui montre comment créer un outil permettant de modifier le manifeste d'application incorporé. Pour plus d'informations, consultez ServerDocument, exemple.

Un autre modèle permet de mettre à jour des manifestes en modifiant des fichiers XML sur un serveur. Pour plus d'informations, consultez Comment : modifier l'emplacement des personnalisations au niveau du document (Office System 2003).

Remarque :

Cette rubrique ne s'applique pas aux compléments au niveau de l'application car ils n'utilisent pas de manifestes d'application incorporés. Pour modifier le chemin d'accès à l'assembly complémentaire, utilisez un éditeur de texte afin de mettre à jour le manifeste d'application présent sur l'ordinateur client. Pour plus d'informations, consultez Manifestes d'application pour les solutions Office (Office System 2003). Pour plus d'informations sur les compléments au niveau de l'application et les personnalisations au niveau du document, consultez Architecture des personnalisations au niveau du document.

Pour modifier par programme le chemin d'accès aux assemblys

  1. Ajoutez une référence à Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 à votre projet de manipulation du modèle objet, si ce n'est pas déjà fait.

  2. Ajoutez une instruction Imports ou using pour l'exécution au début de votre fichier de code.

    Imports Microsoft.VisualStudio.Tools.Applications.Runtime

    using Microsoft.VisualStudio.Tools.Applications.Runtime;

  3. Appelez la méthode statique AddCustomization de la classe ServerDocument et passez les arguments requis. Vous devez d'abord appeler la méthode RemoveCustomization pour supprimer toutes les personnalisations Visual Studio Tools pour Office existantes du document, sinon AddCustomization lèvera une InvalidOperationException.

    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);

Voir aussi

Tâches

Comment : modifier par programme le chemin d'accès du manifeste de déploiement (Office System 2003)

Comment : supprimer des extensions de code managé de documents (Office System 2003)

Concepts

Manifestes d'application et de déploiement dans les solutions Office

Déploiement de solutions Office (Office System 2003)

Référence

Manifestes d'application pour les solutions Office (Office System 2003)

Manifestes de déploiement pour les solutions Office (Office System 2003)