Especifique las opciones de carga
Al cargar un documento, puede establecer algunas propiedades avanzadas. Aspose.Words le proporciona el LoadOptions clase, que permite un control más preciso del proceso de carga. Algunos formatos de carga tienen una clase correspondiente que tiene opciones de carga para este formato de carga, por ejemplo, hay PdfLoadOptions para cargar en formato PDF o TxtLoadOptions para cargar a TXT. Este artículo ofrece ejemplos de trabajo con opciones LoadOptions clase.
Set Microsoft Word Versión para cambiar la apariencia
Diferentes versiones de Microsoft Word la aplicación puede mostrar documentos de forma diferente. Por ejemplo, hay un problema conocido con documentos OOXML como DOCX o DOTX producido con la Oficina de Servicios de Supervisión Interna. En tales casos, pueden faltar elementos esenciales de marcado de documentos o pueden interpretarse de manera diferente causando Microsoft Word 2019 para mostrar este documento de manera diferente en comparación con Microsoft Word 2010.
Por defecto Aspose.Words abre documentos usando Microsoft Word Reglas de 2019. Si necesita hacer que la carga de documentos aparezca como ocurriría en una de las anteriores Microsoft Word versiones de aplicaciones, debe especificar explícitamente la versión deseada usando la MswVersion propiedad de la LoadOptions clase.
El siguiente ejemplo de código muestra cómo establecer el Microsoft Word versión con opciones de carga:
Establecer preferencias de idioma para cambiar la apariencia
Los detalles de mostrar un documento en Microsoft Word depende no sólo de la versión de la aplicación y de la MswVersion valor de propiedad pero también en la configuración del idioma. Microsoft Word puede mostrar documentos de forma diferente dependiendo de la configuración de diálogo “Office Language Preferences”, que se puede encontrar en “File → Opciones → Languаge”. Utilizando este diálogo un usuario puede seleccionar, por ejemplo, el idioma primario, los idiomas de prueba, los idiomas de visualización, etc. Aspose.Words proporciona el LanguagePreferences propiedad como el equivalente de este diálogo. Si Aspose.Words la producción difiere de la Microsoft Word productos, establecer el valor adecuado para EditingLanguage – esto puede mejorar el documento de salida.
El siguiente ejemplo de código muestra cómo establecer el japonés como EditingLanguage:
Uso WarningCallback para controlar los problemas Mientras que carga un documento
Algunos documentos pueden corromperse, contener entradas inválidas o tener características que no estén respaldadas actualmente Aspose.Words. Si quieres saber sobre los problemas que ocurrieron al cargar un documento, Aspose.Words proporciona el IWarningCallback Interfaz.
El siguiente ejemplo de código muestra la implementación de la IWarningCallback interfaz:
Para obtener información sobre todos los problemas durante el tiempo de carga, utilice el WarningCallback propiedad.
El siguiente ejemplo de código muestra cómo utilizar esta propiedad:
Uso de recursos Callback to Control the External Resources Loading
Un documento puede contener enlaces externos a imágenes ubicadas en algún lugar en un disco, red o Internet local. Aspose.Words carga automáticamente tales imágenes en un documento, pero hay situaciones cuando este proceso necesita ser controlado. Por ejemplo, para decidir si realmente necesitamos cargar una determinada imagen o tal vez saltarla. El ResourceLoadingCallback La opción de carga le permite controlar esto.
El siguiente ejemplo de código muestra la implementación de la IResourceLoadingCallback interfaz:
El siguiente ejemplo de código muestra cómo utilizar el ResourceLoadingCallback propiedad:
Use TempFolder para evitar una excepción de memoria
Aspose.Words soporta documentos extremadamente grandes que tienen miles de páginas llenas de contenido rico. Cargar dichos documentos puede requerir mucha RAM. En el proceso de carga, Aspose.Words necesita aún más memoria para mantener estructuras temporales utilizadas para analizar un documento.
Si usted tiene un problema con la excepción Out of Memory mientras carga un documento, trate de utilizar el TempFolder propiedad. En este caso, Aspose.Words almacenará algunos datos en archivos temporales en lugar de memoria, y esto puede ayudar a evitar tal excepción.
El siguiente ejemplo de código muestra cómo establecer TempFolder:
Establecer la codificación Explícitamente
La mayoría de los formatos de documentos modernos almacenan su contenido en Unicode y no requieren un manejo especial. Por otro lado, todavía hay muchos documentos que utilizan algunos encoding pre-Unicode y a veces se pierden la información de codificación o ni siquiera apoyan la codificación de información por naturaleza. Aspose.Words Intenta detectar automáticamente la codificación apropiada por defecto, pero en un caso raro es posible que necesite usar una codificación diferente de la detectada por nuestro algoritmo de reconocimiento de codificación. En este caso, utilice el Encoding propiedad para conseguir o establecer la codificación.
El siguiente ejemplo de código muestra cómo establecer la codificación para anular la codificación elegida automáticamente:
Carga Documentos cifrados
Puedes cargar Documentos de palabras cifrados con una contraseña. Para ello, utilice una sobrecarga especial de constructor, que acepta un LoadOptions objeto. Este objeto contiene el Password propiedad, que especifica la cadena de contraseña.
El siguiente ejemplo de código muestra cómo cargar un documento cifrado con una contraseña:
Si no sabe de antemano si el archivo está encriptado, puede utilizar el FileFormatUtil class, que proporciona métodos de utilidad para trabajar con formatos de archivo, como la detección del formato de archivo o la conversión de extensiones de archivo a / desde enumeraciones de formato de archivo. Para detectar si el documento está encriptado y requiere una contraseña para abrirlo, utilice el IsEncrypted propiedad.
El siguiente ejemplo de código muestra cómo verificar OpenDocument está encriptado o no: