Rozwiązywanie problemów Aspose.Words FOSS for .NET

Ta strona opisuje typowe problemy napotykane przy budowaniu i używaniu Aspose.Words FOSS dla .NET, oraz jak je rozwiązać.

Problemy z budowaniem i instalacją

dotnet add package Aspose.Words nie może znaleźć pakietu

To polecenie odwołuje się do komercyjnego pakietu Aspose.Words, a nie do edycji FOSS — identyfikator pakietu FOSS to Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternatywnie, uruchom git clone, aby pobrać źródło, następnie cd do sklonowanego folderu i uruchom dotnet build na rozwiązaniu:

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

Następnie dodaj odwołanie do projektu Aspose.Words.csproj z własnej aplikacji, zamiast odwołania do pakietu.

Odwołanie do projektu nie jest rozwiązywane po sklonowaniu

Upewnij się, że odwołanie wskazuje na Aspose.Words.csproj wewnątrz sklonowanego folderu Aspose.Words-FOSS-for-.NET/Aspose.Words/ oraz że rozwiązanie zostało najpierw pomyślnie zbudowane (dotnet build Aspose.Words.sln -c Release). Biblioteka celuje w .NET Standard 2.0, więc każde SDK celujące w .NET Framework 4.6.2+ lub .NET 6/8/10 może się do niej odwołać.

Problemy z ładowaniem

UnsupportedFileFormatException podczas ładowania dokumentu

UnsupportedFileFormatException jest zgłaszany podczas ładowania, gdy format pliku nie jest rozpoznany lub nie jest obsługiwany przez tę edycję. Formatami ładowania w tej edycji są DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown oraz zwykły tekst — przekazanie nieobsługiwanego ścieżki, takiej jak input.doc, do konstruktora Document powoduje wyrzucenie tego wyjątku zamiast zwrócenia załadowanego dokumentu:

using Aspose.Words;

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

Przechwycenie UnsupportedFileFormatException wokół konstruktora Document pozwala zgłosić czytelną wiadomość zamiast pozwolić, aby wyjątek propagował się jako surowy stos śladu.

FileCorruptedException w pliku, który wygląda na prawidłowy

FileCorruptedException jest zgłaszany podczas ładowania, gdy plik wydaje się uszkodzony i nie może być sparsowany — na przykład plik .docx, który nie jest prawidłowym pakietem OOXML opartym na ZIP, lub plik ucięty podczas transferu. Pobierz ponownie plik ze źródła i upewnij się, że otwiera się poprawnie przed wczytaniem go za pomocą Document.

IncorrectPasswordException przy otwieraniu chronionego dokumentu

Jest to zgłaszane, gdy dokument jest zaszyfrowany hasłem, a hasło podane do przeciążenia LoadOptions konstruktora Document jest brakujące lub niepoprawne. Podaj prawidłowe hasło za pomocą LoadOptions.Password przed wczytaniem.

Problemy z zapisywaniem i eksportem

Nie udaje się Document.Save() do PDF, XPS lub formatu obrazu

Ta edycja nie zawiera podsystemu układu strony i renderowania, więc Document.Save() nie może eksportować do PDF, XPS ani formatów obrazu.

Zapisz jako DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown lub zwykły tekst — to są formaty, które ta edycja rzeczywiście zapisuje. Komercyjna Aspose.Words for .NET dodaje PDF, XPS i wyjście obrazu.

Numery stron i pozycje spisu treści zawsze wyświetlają 0

Aspose.Words FOSS dla .NET zawiera pełny silnik oceny pól, więc pola treści takie jak DATE i DOCPROPERTY są aktualizowane poprawnie. Pola zależne od układu strony — numery stron, NUMPAGES i pozycje spisu treści — zwracają wartość zastępczą 0 zamiast obliczonej, ponieważ ta edycja nie zawiera silnika układu, który normalnie paginuje dokument. Jest to oczekiwane zachowanie w tej edycji, a nie błąd.

Problemy z podpisem cyfrowym

Podpisywanie dokumentu nie przynosi efektu

DigitalSignatureUtil.Sign() i powiązane API podpisywania istnieją w modelu obiektowym w celu zachowania strukturalnej kompatybilności z produktem komercyjnym, ale tworzenie nowego podpisu nie jest funkcjonalne w tej edycji FOSS — wywołanie ich nie generuje podpisanego wyniku. Ta edycja może przeglądać i weryfikować podpisy już dołączone do dokumentu przy użyciu Document.DigitalSignatures i DigitalSignatureUtil.LoadSignatures(), jednak przepływ pracy podpisywania wymaga komercyjnego Aspose.Words dla .NET.

Problemy z czcionkami

Osadzone czcionki są większe niż oczekiwano

Gdy EmbedTrueTypeFonts jest włączone, czcionki są osadzane jako całe pliki, a nie podzbiory zawierające tylko glify faktycznie użyte w dokumencie, więc zapisywane pliki z osadzonymi czcionkami są większe niż równoważny wynik produktu komercyjnego. Nie ma obejścia w tej edycji — podzielenie osadzonych czcionek nie jest uwzględnione.