Solución de problemas Aspose.Words FOSS for .NET

Esta página cubre los problemas comunes que se encuentran al compilar y usar Aspose.Words FOSS para .NET, y cómo resolverlos.

Problemas de compilación e instalación

dotnet add package Aspose.Words no puede encontrar el paquete

Ese comando se resuelve al paquete comercial Aspose.Words, no a la edición FOSS — el ID del paquete FOSS es Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativamente, ejecuta git clone para obtener el código fuente, luego cd en la carpeta clonada y ejecuta dotnet build sobre la solución:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

Luego añada una referencia de proyecto a Aspose.Words.csproj desde su propia aplicación en lugar de una referencia de paquete.

La referencia de proyecto no se resuelve después de clonar.

Confirme que la referencia apunta a Aspose.Words.csproj dentro de la carpeta Aspose.Words-FOSS-for-.NET/Aspose.Words/ clonada, y que la solución se construyó correctamente primero (dotnet build Aspose.Words.sln -c Release). La biblioteca se dirige a .NET Standard 2.0, por lo que cualquier SDK que apunte a .NET Framework 4.6.2+ o .NET 6/8/10 puede referenciarla.

Problemas de carga

UnsupportedFileFormatException al cargar un documento

UnsupportedFileFormatException se lanza durante la carga cuando el formato de archivo no es reconocido o no es compatible con esta edición. Los formatos de carga de esta edición son DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown y texto plano — pasar una ruta no compatible como input.doc al constructor Document genera esta excepción en lugar de devolver un documento cargado:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

Capturar UnsupportedFileFormatException alrededor del constructor Document le permite informar un mensaje claro en lugar de permitir que la excepción se propague como una traza de pila sin procesar.

FileCorruptedException en un archivo que parece válido

FileCorruptedException se lanza durante la carga cuando el archivo parece estar dañado y no se puede analizar — por ejemplo, un archivo .docx que no es un paquete OOXML basado en ZIP válido, o un archivo truncado durante la transferencia. Obtenga de nuevo el archivo de su origen y confirme que se abre correctamente antes de cargarlo con Document.

IncorrectPasswordException al abrir un documento protegido

Esto se lanza cuando un documento está cifrado con una contraseña y la contraseña suministrada al sobrecarga LoadOptions del constructor Document falta o es incorrecta. Proporcione la contraseña correcta a través de LoadOptions.Password antes de cargar.

Problemas al guardar y exportar

Falla Document.Save() a PDF, XPS o una extensión de imagen

Esta edición no incluye el subsistema de maquetación y renderizado, por lo que Document.Save() no puede exportar a PDF, XPS o formatos de imagen.

Guarde en DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown o texto sin formato en su lugar — esos son los formatos que esta edición realmente escribe. El comercial Aspose.Words para .NET agrega PDF, XPS y salida de imagen.

Los números de página y las entradas del índice siempre muestran 0

Aspose.Words FOSS para .NET incluye un motor completo de evaluación de campos, por lo que los campos de contenido como DATE y DOCPROPERTY se actualizan correctamente. Los campos que dependen del diseño de página — números de página, NUMPAGES, y entradas del TOC — se evalúan a un marcador de posición 0 en lugar de un valor calculado, porque esta edición no incluye el motor de diseño que normalmente paginaría el documento. Este es un comportamiento esperado en esta edición, no un error.

Problemas de firma digital

Firmar un documento no tiene efecto

DigitalSignatureUtil.Sign() y las APIs de firma relacionadas existen en el modelo de objetos para compatibilidad estructural con el producto comercial, pero crear una nueva firma no es funcional en esta edición FOSS — llamarlas no produce una salida firmada. Esta edición puede inspeccionar y verificar firmas ya adjuntas a un documento mediante Document.DigitalSignatures y DigitalSignatureUtil.LoadSignatures(), pero un flujo de trabajo de firma requiere el Aspose.Words comercial para .NET.

Problemas de fuentes

Las fuentes incrustadas son más grandes de lo esperado

Cuando EmbedTrueTypeFonts está habilitado, las fuentes se incrustan como archivos completos en lugar de subestablecerse solo a los glifos realmente usados en el documento, por lo que los archivos guardados que incrustan fuentes son más grandes que la salida equivalente del producto comercial. No hay solución alternativa en esta edición — la subestablecimiento de fuentes incrustadas no está incluido.