Resolução de problemas Aspose.Words FOSS for .NET

Esta página cobre os problemas comuns encontrados ao compilar e usar Aspose.Words FOSS para .NET, e como resolvê-los.

Problemas de Compilação e Instalação

dotnet add package Aspose.Words não consegue encontrar o pacote

Esse comando resolve para o pacote comercial Aspose.Words, não para a edição FOSS — o ID do pacote FOSS é Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativamente, execute git clone para obter o código-fonte, então cd na pasta clonada e execute dotnet build na solução:

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

Em seguida, adicione uma referência de projeto a Aspose.Words.csproj a partir da sua própria aplicação em vez de uma referência de pacote.

A referência de projeto não é resolvida após a clonagem.

Confirme se a referência aponta para Aspose.Words.csproj dentro da pasta Aspose.Words-FOSS-for-.NET/Aspose.Words/ clonada, e se a solução foi compilada com sucesso primeiro (dotnet build Aspose.Words.sln -c Release). A biblioteca tem como alvo .NET Standard 2.0, portanto qualquer SDK que tenha como alvo .NET Framework 4.6.2+ ou .NET 6/8/10 pode referenciá-la.

Problemas de carregamento

UnsupportedFileFormatException ao carregar um documento

UnsupportedFileFormatException é lançada durante o carregamento quando o formato do arquivo não é reconhecido ou não é suportado por esta edição. Os formatos de carregamento desta edição são DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown e texto simples — passar um caminho não suportado como input.doc para o construtor Document gera essa exceção em vez de retornar um documento carregado:

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 ao redor do construtor Document permite que você registre uma mensagem clara em vez de deixar a exceção propagar como um rastreamento de pilha bruto.

FileCorruptedException em um arquivo que parece válido

FileCorruptedException é lançado durante o carregamento quando o arquivo parece corrompido e não pode ser analisado — por exemplo, um arquivo .docx que não é um pacote OOXML baseado em ZIP válido, ou um arquivo truncado durante a transferência. Recupere o arquivo da sua origem e confirme que ele abre corretamente antes de carregá-lo com Document.

IncorrectPasswordException ao abrir um documento protegido

Isso é lançado quando um documento está criptografado com uma senha e a senha fornecida ao overload LoadOptions do construtor Document está ausente ou incorreta. Forneça a senha correta através de LoadOptions.Password antes de carregar.

Problemas ao Salvar e Exportar

Falha ao Document.Save() para PDF, XPS ou extensão de imagem

Esta edição não inclui o subsistema de layout de página e renderização, portanto Document.Save() não pode exportar para PDF, XPS ou formatos de imagem.

Salve como DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown ou texto simples — esses são os formatos que esta edição realmente grava. O comercial Aspose.Words para .NET adiciona saída PDF, XPS e de imagem.

Números de página e entradas do índice sempre exibem 0

Aspose.Words FOSS para .NET inclui um mecanismo completo de avaliação de campos, de modo que campos de conteúdo como DATE e DOCPROPERTY são atualizados corretamente. Campos que dependem do layout da página — números de página, NUMPAGES, e entradas do sumário — avaliam para um placeholder 0 em vez de um valor calculado, porque esta edição não inclui o motor de layout que normalmente paginaria o documento. Este é o comportamento esperado nesta edição, não um bug.

Problemas de Assinatura Digital

Assinar um documento não tem efeito

DigitalSignatureUtil.Sign() e as APIs de assinatura relacionadas existem no modelo de objeto para compatibilidade estrutural com o produto comercial, mas criar uma nova assinatura não é funcional nesta edição FOSS — chamá-las não produz uma saída assinada. Esta edição pode inspecionar e verificar assinaturas já anexadas a um documento através de Document.DigitalSignatures e DigitalSignatureUtil.LoadSignatures(), mas um fluxo de assinatura requer o Aspose.Words comercial para .NET.

Problemas de Fonte

Fontes incorporadas são maiores do que o esperado

Quando EmbedTrueTypeFonts está habilitado, as fontes são incorporadas como arquivos completos em vez de serem subdefinidas apenas para os glifos realmente usados no documento, de modo que os arquivos salvos que incorporam fontes são maiores do que a saída equivalente do produto comercial. Não há solução alternativa nesta edição — a subdefinição de fontes incorporadas não está incluída.