Cómo trabajar con las propiedades del documento en .NET

Paso 1: Leer y establecer propiedades de documento incorporadas

Document.BuiltInDocumentProperties devuelve una colección BuiltInDocumentProperties. Dado que es un conjunto fijo y conocido de propiedades, los valores se leen y escriben como miembros ordinarios en lugar de buscarse por nombre — por ejemplo BuiltInDocumentProperties.Author, .Title, .Subject, .Manager, .Company, .Category, .Keywords y .Comments para campos descriptivos, o .CreatedTime, .LastSavedTime, .LastPrinted y .LastSavedBy para marcas de tiempo. Estadísticas como .Characters, .CharactersWithSpaces, .Lines y .Bytes también se exponen de esta manera, junto a .Template y .HyperlinkBase.

Paso 2: Añadir una propiedad de documento personalizada

Document.CustomDocumentProperties devuelve una colección CustomDocumentProperties para metadatos definidos por la aplicación que no forman parte del conjunto incorporado de Word. Llame a una de las sobrecargas Add(name, value) con un nombre y un valor tipado — cadena, número, booleano o fecha, según la sobrecarga que coincida con el tipo del valor — para crear una nueva propiedad.

Paso 3: Vincular una Propiedad Personalizada al Contenido del Documento

En lugar de un valor estático, una propiedad personalizada puede rastrear un rango de contenido marcado con un marcador para que su valor permanezca sincronizado con ese contenido. Llame a CustomDocumentProperties.AddLinkToContent(name, linkSource), pasando un nombre de marcador como linkSource, en lugar de volver a sincronizar manualmente una propiedad estática cada vez que el contenido vinculado cambie.

Paso 4: Buscar, Verificar y Eliminar Propiedades

Tanto BuiltInDocumentProperties como CustomDocumentProperties derivan del abstracto DocumentPropertyCollection, por lo que se inspeccionan de la misma manera: indexar por nombre (p. ej., properties[name]) recupera una propiedad, Contains(name) verifica si existe, IndexOf(name) devuelve su posición y Count indica cuántas propiedades contiene la colección. Llame a Contains(name) antes de indexar por nombre cuando una propiedad personalizada pueda no existir, para evitar manejar una propiedad faltante como una ruta de excepción. Elimine una propiedad con Remove(name) o RemoveAt(index), o limpie todas las propiedades de la colección con Clear().

Paso 5: Leer el Valor de una Propiedad Personalizada sin Conocer su Tipo de Antemano

Un DocumentProperty tiene un Name, un Value sin tipo, y un Type — un valor de enumeración PropertyType: Boolean, DateTime, Double, Number, String, StringArray, ObjectArray, ByteArray o Other. Debido a que Value no tiene tipo, use el accesor tipado correspondiente en lugar de convertir directamente: ToInt(), ToDouble(), ToDateTime(), ToBool(), ToByteArray() o ToString(). Verifique IsLinkToContent y LinkSource para averiguar si una propiedad está vinculada al contenido del documento (ver Paso 3) en lugar de contener un valor estático.

Paso 6: Verificar el Estado de Protección de un Documento

BuiltInDocumentProperties.Security informa un valor DocumentSecurity que describe los metadatos de protección almacenados del documento: None, PasswordProtected, ReadOnlyRecommended, ReadOnlyEnforced o ReadOnlyExceptAnnotations. Lea esta propiedad antes de decidir si se necesita un procesamiento adicional relacionado con la protección en un documento cargado.