Cómo trabajar con marcado personalizado XML en .NET

Paso 1: Leer datos personalizados XML de un documento

Document.CustomXmlParts devuelve un CustomXmlPartCollection — el mismo mecanismo que Word usa para respaldar los controles de contenido mapeados a XML. Itera la colección, o llama a GetById(id) cuando ya sabes qué parte necesitas, para obtener un CustomXmlPart. Cada parte expone Id, una matriz de bytes Data que contiene el XML sin procesar, un DataChecksum para detectar si los datos han cambiado sin una comparación completa de bytes, y Schemas — un CustomXmlSchemaCollection que enumera los esquemas XML asociados a ella.

Paso 2: Agregar o actualizar una parte personalizada XML

Llama a CustomXmlPartCollection.Add(id, xml) con una cadena id y el contenido de XML para crear una parte directamente, o construye un CustomXmlPart por separado y pásalo a Add(part). Para eliminar datos, usa RemoveAt(index) en una posición específica o Clear() para descartar cada parte. Al copiar datos personalizados de XML entre documentos, usa CustomXmlPart.Clone() (o el Clone() de la colección) en la parte origen en lugar de volver a leer y volver a agregar el XML sin procesar, luego agrega el clon al Document.CustomXmlParts del documento de destino.

Paso 3: Gestionar los esquemas asociados a una parte

CustomXmlPart.Schemas llega a un CustomXmlSchemaCollection, que registra los URI de esquemas asociados con la parte como cadenas simples en lugar de objetos de esquema analizados. Usa Add(value) para registrar un URI de esquema, Remove(name) o RemoveAt(index) para eliminar uno, IndexOf(value) para localizar uno, y Clear() para removerlos todos. Count informa cuántos URI de esquemas están actualmente asociados con la parte.

Paso 4: Trabajar con partes personalizadas a nivel de paquete

No todas las partes no visibles en un paquete OOXML son XML personalizados. Document.PackageCustomParts devuelve un CustomPartCollection de objetos CustomPart — partes arbitrarias almacenadas en el paquete, como partes añadidas por otra aplicación que modificó el archivo. Cada CustomPart tiene un Name, ContentType, RelationshipType, una matriz de bytes Data, y una bandera IsExternal que indica si es una referencia externa en lugar de contenido incrustado. Add(part), RemoveAt(index) y Clear() gestionan la colección de la misma manera que CustomXmlPartCollection. Verifica PackageCustomParts — no CustomXmlParts — cuando una parte que tu documento debería contener no aparece en la colección XML personalizada.

Paso 5: Inspeccionar etiquetas inteligentes heredadas y sus propiedades

SmartTag es un tipo de nodo (NodeType.SmartTag, construido con SmartTag(doc)) que representa una etiqueta inteligente heredada de Word envuelta alrededor del texto reconocido. Verifica Element y Uri juntos para identificar qué reconocedor creó la etiqueta, luego lee Properties — un CustomXmlPropertyCollection — para los datos estructurados que el reconocedor adjuntó. Dentro de un CustomXmlPropertyCollection, el indexador (p. ej. properties["MyProp"]) o Contains(name) buscan una propiedad específica, IndexOfKey(name) devuelve su posición, y Remove(name)/RemoveAt(index)/Clear() eliminan entradas; cada CustomXmlProperty se construye con CustomXmlProperty(name, uri, value) y expone Name, Uri y Value. Debido a que SmartTag deriva de CompositeNode, también participa en el árbol del documento como otros nodos, soportando Accept(visitor), AcceptStart(visitor) y AcceptEnd(visitor) para la traversía basada en DocumentVisitor.