Trabajar con Propiedades de documento
Las propiedades del documento permiten almacenar información útil sobre su documento. Estas propiedades se pueden dividir en dos grupos:
- Sistema o incorporado que contenga valores como título de documento, nombre de autor, estadísticas de documentos y otros.
- Definido o personalizado, proporcionado como pares de valor de nombre donde el usuario puede definir tanto el nombre como el valor.
Es útil saber que información sobre API y el número de versión está escrito directamente a los documentos de salida. Por ejemplo, al convertir un documento en PDF, Aspose.Words llena el campo “Aplicación” con “Aspose.Words”, y el campo “Productor de PDF” con “Aspose.Words para Java YY.M.N, donde YY.M.N es la versión de Aspose.Words utilizado para la conversión. Para más detalles, consulte Nombre del generador o productor Incluido en documentos de salida.
Access Document Properties
Para acceder a las propiedades del documento Aspose.Words uso:
-
BuiltInDocumentProperties para obtener propiedades incorporadas.
-
CustomDocumentProperties para obtener propiedades personalizadas.
BuiltInDocumentProperties y CustomDocumentProperties son colecciones de DocumentProperty objetos. Estos objetos se pueden obtener a través de la propiedad indexador por nombre o por índice.
BuiltInDocumentProperties Además, proporciona acceso a propiedades de documentos a través de un conjunto de propiedades introducidas que devuelven valores del tipo apropiado. CustomDocumentProperties le permite añadir o eliminar las propiedades del documento de un documento.
El DocumentProperty clase le permite obtener el nombre, el valor y el tipo de una propiedad de documento. [Valor]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) devuelve un objeto, pero hay un conjunto de métodos que le permiten convertir el valor de propiedad a un tipo específico. Después de saber qué tipo de propiedad es, puede utilizar uno de los {0} métodos, como {1}ToString y DocumentProperty.ToInt, para obtener el valor del tipo apropiado.
El siguiente ejemplo de código muestra cómo enumerar todas las propiedades incorporadas y personalizadas en un documento:
In Microsoft Word, puede acceder a las propiedades del documento utilizando el menú “File → Properties”.
Agregar o eliminar propiedades del documento
No puede agregar o eliminar propiedades de documentos incorporadas usando Aspose.Words. Sólo puede cambiar o actualizar sus valores.
Para añadir propiedades de documento personalizadas con Aspose.Words, utilizar el Add método, pasando el nuevo nombre de propiedad y el valor del tipo apropiado. El método devuelve el nuevo creado DocumentProperty objeto.
Para eliminar las propiedades personalizadas, utilice Remove método, pasando el nombre de la propiedad para eliminar, o RemoveAt método para eliminar la propiedad por índice. También puede eliminar todas las propiedades usando el Clear método.
El siguiente ejemplo de código comprueba si una propiedad personalizada con un nombre determinado existe en un documento y añade algunas propiedades de documentos más personalizadas:
El siguiente ejemplo de código muestra cómo eliminar una propiedad de documento personalizada:
Actualizar Propiedades de documentos incorporadas
Aspose.Words no actualiza automáticamente las propiedades del documento, como Microsoft Word hace con algunas propiedades, pero proporciona un método para actualizar algunas propiedades estadísticas de documentos incorporados. Llama a la UpdateWordCount método para recalcular y actualizar las siguientes propiedades:
Crear una nueva propiedad personalizada vinculada al contenido
Aspose.Words proporciona el AddLinkToContent método para crear una nueva propiedad de documento personalizado vinculada al contenido. Esta propiedad devuelve el objeto de propiedad recientemente creado o null si el LinkSource es inválido.
El siguiente ejemplo de código muestra cómo configurar un enlace a una propiedad personalizada:
Obtener variables de documento
Usted puede obtener una colección de variables de documento usando la Variables propiedad. Los nombres y valores 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, puede que desee eliminar información personal como el nombre del autor y la empresa. Para ello utiliza el RemovePersonalInformation propiedad para establecer la bandera indicando que Microsoft Word eliminará toda la información del usuario de comentarios, revisiones y propiedades de documentos al guardar el documento.