Trabajar con Propiedades de Documentos
Las propiedades del documento permiten almacenar cierta información útil sobre su documento. Estas propiedades se pueden dividir en dos grupos:
- Sistema o integrado que contienen valores como título del documento, nombre del autor, estadísticas del documento y otros.
- Definido por el usuario o personalizado, proporcionado como pares nombre-valor donde el usuario puede definir tanto el nombre como el valor.
Es útil saber que la información sobre la API y el Número de versión se escribe directamente en los documentos de salida. Por ejemplo, al convertir un documento a PDF, Aspose.Words completa el campo" Solicitud “con” Aspose.Words" y el campo" PDF Productor " con “Aspose.Words para C++ YY.M. N”, donde YY.M.N es la versión de Aspose.Words utilizada para la conversión. Para más detalles, consulte Nombre del Generador o Productor Incluido en los Documentos de Salida.
Acceder a las Propiedades del Documento
Para acceder a las propiedades del documento en Aspose.Words, use:
-
BuiltInDocumentProperties para obtener propiedades integradas.
-
CustomDocumentProperties para obtener propiedades personalizadas.
BuiltInDocumentProperties
BuiltInDocumentProperties
La clase DocumentProperty le permite obtener el nombre, el valor y el tipo de una propiedad de documento. Value devuelve un objeto, pero hay un conjunto de métodos que le permiten convertir el valor de la propiedad a un tipo específico. Una vez que sepa qué tipo es la propiedad, puede usar uno de los métodos DocumentProperty.ToXXX, como DocumentProperty.ToString y DocumentProperty.ToInt, para obtener el valor del tipo apropiado.
El siguiente ejemplo de código muestra cómo enumerar todas las propiedades integradas y personalizadas en un documento:
En Microsoft Word, puede acceder a las propiedades del documento utilizando el menú" Archivo → Propiedades".
Agregar o Quitar Propiedades del documento
No puede agregar ni quitar propiedades de documento integradas con Aspose.Words. Solo puedes cambiar o actualizar sus valores.
Para agregar propiedades de documento personalizadas con Aspose.Words, use el método Add, pasando el nuevo nombre de propiedad y el valor del tipo apropiado. El método devuelve el objeto DocumentProperty recién creado.
Para eliminar propiedades personalizadas, use el método Remove, pasándole el nombre de la propiedad para eliminar, o el método RemoveAt para eliminar la propiedad por índice. También puede eliminar todas las propiedades utilizando el método Clear.
El siguiente ejemplo de código comprueba si existe una propiedad personalizada con un nombre dado en un documento y agrega algunas propiedades de documento personalizadas más:
El siguiente ejemplo de código muestra cómo eliminar una propiedad de documento personalizada:
Actualizar las Propiedades Integradas del Documento
Aspose.Words no actualiza automáticamente las propiedades del documento, como lo hace Microsoft Word con algunas propiedades, pero proporciona un método para actualizar algunas propiedades estadísticas integradas del documento. Llame al método UpdateWordCount para recalcular y actualizar las siguientes propiedades:
Crear una Nueva Propiedad Personalizada Vinculada al Contenido
Aspose.Words proporciona el método AddLinkToContent para crear una nueva propiedad de documento personalizada vinculada al contenido. Esta propiedad devuelve el objeto de propiedad recién creado o nulo si LinkSource no es válido.
El siguiente ejemplo de código muestra cómo configurar un enlace a una propiedad personalizada:
Obtener Variables de Documento
Puede obtener una colección de variables de documento utilizando la propiedad Variables. Los nombres y valores de las variables son cadenas.
El siguiente ejemplo de código muestra cómo enumerar variables de documento:
Eliminar Información Personal del Documento
Si desea compartir un documento de Word con otras personas, es posible que desee eliminar información personal, como el nombre del autor y la empresa. Para hacer esto, use la propiedad RemovePersonalInformation para establecer el indicador que indica que Microsoft Word eliminará toda la información del usuario de los comentarios, revisiones y propiedades del documento al guardar el documento.
El siguiente ejemplo de código muestra cómo eliminar información personal: