Comment travailler avec le balisage XML personnalisé dans .NET

Étape 1 : Lire les données personnalisées XML d’un document

Document.CustomXmlParts renvoie un CustomXmlPartCollection — le même mécanisme que Word utilise pour prendre en charge les contrôles de contenu mappés XML. Parcourez la collection, ou appelez GetById(id) lorsque vous savez déjà quelle partie vous faut, pour obtenir un CustomXmlPart. Chaque partie expose Id, un Data tableau d’octets contenant le XML brut, un DataChecksum permettant de détecter si les données ont changé sans une comparaison complète d’octets, et Schemas — un CustomXmlSchemaCollection répertoriant les schémas XML qui lui sont associés.

Étape 2 : Ajouter ou mettre à jour une partie personnalisée XML

Appelez CustomXmlPartCollection.Add(id, xml) avec une chaîne d’identifiant et le contenu XML pour créer directement une partie, ou construisez un CustomXmlPart séparément et transmettez-le à Add(part). Pour supprimer des données, utilisez RemoveAt(index) sur une position spécifique ou Clear() pour éliminer chaque partie. Lors de la copie de données XML personnalisées entre documents, utilisez CustomXmlPart.Clone() (ou le Clone() de la collection) sur la partie source plutôt que de relire et de réajouter le XML brut, puis ajoutez le clone au Document.CustomXmlParts du document cible.

Étape 3 : Gérer les schémas associés à une partie

CustomXmlPart.Schemas atteint un CustomXmlSchemaCollection, qui suit les URI de schéma associés à la partie sous forme de chaînes simples plutôt que d’objets de schéma analysés. Utilisez Add(value) pour enregistrer une URI de schéma, Remove(name) ou RemoveAt(index) pour en supprimer une, IndexOf(value) pour en localiser une, et Clear() pour les enlever toutes. Count indique le nombre d’URI de schéma actuellement associés à la partie.

Étape 4 : Travailler avec les parties personnalisées au niveau du package

Tous les éléments non visibles d’un package OOXML ne sont pas des XML personnalisés. Document.PackageCustomParts renvoie un CustomPartCollection d’objets CustomPart — des parties arbitraires stockées dans le package, telles que des parties ajoutées par une autre application qui a modifié le fichier. Chaque CustomPart possède un Name, un ContentType, un RelationshipType, un tableau d’octets Data, et un indicateur IsExternal indiquant s’il s’agit d’une référence externe plutôt que d’un contenu incorporé. Add(part), RemoveAt(index) et Clear() gèrent la collection de la même façon que CustomXmlPartCollection. Vérifiez PackageCustomParts — et non CustomXmlParts — lorsqu’une partie que votre document doit contenir n’apparaît pas dans la collection XML personnalisée.

Étape 5 : Inspecter les balises intelligentes héritées et leurs propriétés

SmartTag est un type de nœud (NodeType.SmartTag, construit avec SmartTag(doc)) représentant une balise intelligente Word héritée enveloppant du texte reconnu. Vérifiez Element et Uri ensemble pour identifier quel reconnaisseur a créé la balise, puis lisez Properties — un CustomXmlPropertyCollection — pour les données structurées que le reconnaisseur a attachées. Dans un CustomXmlPropertyCollection, l’indexeur (p. ex. properties["MyProp"]) ou Contains(name) recherchent une propriété spécifique, IndexOfKey(name) renvoie sa position, et Remove(name)/RemoveAt(index)/Clear() suppriment les entrées; chaque CustomXmlProperty est construit avec CustomXmlProperty(name, uri, value) et expose Name, Uri et Value. Parce que SmartTag dérive de CompositeNode, il participe également à l’arbre du document comme les autres nœuds, prenant en charge Accept(visitor), AcceptStart(visitor) et AcceptEnd(visitor) pour une traversée basée sur DocumentVisitor.