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

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. 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.

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

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 supprimer par programme l'assembly de personnalisation Visual Studio Tools pour Office d'un document ou d'un classeur qui fait partie d'une personnalisation au niveau du document pour Microsoft Office 2003. Les utilisateurs peuvent alors ouvrir les documents et afficher le contenu, mais les interfaces utilisateur personnalisées que vous ajoutez aux documents n'apparaissent pas et votre code ne s'exécute pas. Lorsque vous supprimez l'assembly, vous pouvez laisser les données en mémoire cache dans le document ou les supprimer :

Si vous souhaitez conserver les données en mémoire cache, effacez le manifeste d'application incorporé dans le document. Il peut être utile de conserver les données en mémoire cache si, par la suite, elles doivent être lues par une page ASP.NET ou une application serveur.
Si vous n'avez plus besoin des données en mémoire cache, supprimez le manifeste d'application et les données en mémoire cache.

Le runtime Visual Studio Tools pour Office inclut un modèle objet qui vous permet d'exécuter ces actions par programme.

Suppression du manifeste d'application incorporé

Utilisez la classe ServerDocument pour supprimer uniquement le manifeste d'application incorporé. Vous devez placer un code qui utilise la classe ServerDocument dans un nouveau projet (et non dans votre solution Visual Studio Tools pour Office) ; par exemple, dans un projet d'application console ou Windows Forms.

Pour effacer le manifeste d'application incorporé

Créez un nouveau projet, par exemple une application console ou un projet Windows Forms.
Ajoutez au projet une référence à l'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

Ajoutez l'instruction Imports ou using suivante en haut de votre fichier de code.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

Créez une instance de ServerDocument et passez le document de la solution. Appelez la méthode Clear de la propriété AppManifest.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\Documents\SolutionDocument.doc")
    sd.AppManifest.Clear()

ServerDocument sd = null;
try 
{
    sd = new ServerDocument(@"C:\Documents\SolutionDocument.doc");
    sd.AppManifest.Clear();

Enregistrez vos modifications et fermez le document.

    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Suppression du manifeste d'application incorporé et des données en mémoire cache

Vous pouvez supprimer du document le manifeste d'application incorporé et les données en mémoire cache en utilisant l'une des méthodes RemoveCustomization :

Pour un document ouvert sur un ordinateur client, utilisez la méthode Document.RemoveCustomization ou Workbook.RemoveCustomization.
Pour un document fermé ou un document sur un serveur, utilisez la méthode ServerDocument.RemoveCustomization.

Remarque :
Les méthodes Document.RemoveCustomization et Workbook.RemoveCustomization suppriment également du document le contrôle Runtime Storage. Pour plus d'informations sur le contrôle Runtime Storage, consultez : Vue d'ensemble du contrôle Runtime Storage.

Pour supprimer le manifeste d'application incorporé et les données en mémoire cache d'un document ouvert sur un ordinateur client

Dans votre projet au niveau du document pour Microsoft Office Word ou Microsoft Office Excel, appelez la méthode Document.RemoveCustomization (pour Word) ou Workbook.RemoveCustomization (pour Excel).

Pour supprimer le manifeste d'application incorporé et les données en mémoire cache d'un document fermé ou d'un document sur un serveur

Créez un nouveau projet, par exemple une application console ou un projet Windows Forms.
Ajoutez au projet une référence à l'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

Ajoutez l'instruction Imports ou using suivante en haut de votre fichier de code.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

Appelez la méthode statique RemoveCustomization de la classe ServerDocument et spécifiez le chemin d'accès du document de solution pour le paramètre.

If (ServerDocument.IsCustomized("C:\Documents\SolutionDocument.doc")) Then

    ServerDocument.RemoveCustomization("C:\Documents\SolutionDocument.doc")
End If

if (ServerDocument.IsCustomized(@"C:\Documents\SolutionDocument.doc"))
{
    ServerDocument.RemoveCustomization(@"C:\Documents\SolutionDocument.doc");
}

Voir aussi

Tâches

Comment : pour écrire du code qui utilise les deux versions de la classe ServerDocument

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

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

Comment : joindre des extensions de code managé à des documents (Office System 2007)

Concepts

Gestion de documents sur un serveur à l'aide de la classe ServerDocument

Mise en cache des données

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

Partager via