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 integrado que contiene valores como título del documento, nombre del autor, estadísticas del documento y otros.
- Definido por el usuario o personalizado, proporcionado como pares de nombre-valor donde el usuario puede definir tanto el nombre como el valor.
Es útil saber que la información sobre 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 “Aplicación” con “Aspose.Words” y el campo “Productor de PDF” con “Aspose.Words para .NET YY.MN”, donde YY.M.N es la versión de Aspose.Words utilizada para la conversión.. Para obtener 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, utilice:
-
BuiltInDocumentProperties para obtener propiedades integradas.
-
CustomDocumentProperties para obtener propiedades personalizadas.
BuiltInDocumentProperties y CustomDocumentProperties son colecciones de objetos DocumentProperty. Estos objetos se pueden obtener a través de la propiedad del indexador por nombre o por índice.
BuiltInDocumentProperties además proporciona acceso a las propiedades del documento a través de un conjunto de propiedades ingresadas que devuelven valores del tipo apropiado. CustomDocumentProperties le permite agregar o eliminar propiedades de un documento.
La clase DocumentProperty le permite obtener el nombre, valor y tipo de propiedad de un documento. Value devuelve un objeto, pero existe un conjunto de métodos que le permiten convertir el valor de la propiedad a un tipo específico. Una vez que sepa de qué tipo es la propiedad, puede utilizar 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 eliminar propiedades de documentos integradas utilizando Aspose.Words. Sólo puede cambiar o actualizar sus valores.
Para agregar propiedades de documentos 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, utilice el método Remove, pasándole el nombre de la propiedad a 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 determinado 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 del documento integrado
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 volver a calcular 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 el LinkSource no es válido.
El siguiente ejemplo de código muestra cómo configurar un vínculo a una propiedad personalizada:
Obtener variables del documento
Puede obtener una colección de variables de documentos 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 la bandera que indica que Microsoft Word eliminará toda la información del usuario de los comentarios, revisiones y propiedades del documento al guardarlo.
El siguiente ejemplo de código muestra cómo eliminar información personal: