Fehlerbehebung Aspose.Words FOSS for .NET

Diese Seite behandelt häufige Probleme, die beim Erstellen und Verwenden von Aspose.Words FOSS für .NET auftreten, und wie man sie löst.

Build- und Installationsprobleme

dotnet add package Aspose.Words kann das Paket nicht finden

Dieser Befehl verweist auf das kommerzielle Aspose.Words-Paket, nicht auf die FOSS-Edition — die FOSS-Paket-ID ist Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternativ führen Sie git clone aus, um den Quellcode zu erhalten, dann cd in den geklonten Ordner und führen dotnet build für die Lösung aus:

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

Dann fügen Sie einen Projektverweis auf Aspose.Words.csproj aus Ihrer eigenen Anwendung hinzu, anstatt eines Paketverweises.

Der Projektverweis wird nach dem Klonen nicht aufgelöst.

Stellen Sie sicher, dass der Verweis auf Aspose.Words.csproj im geklonten Aspose.Words-FOSS-for-.NET/Aspose.Words/-Ordner zeigt und dass die Lösung zunächst erfolgreich gebaut wurde (dotnet build Aspose.Words.sln -c Release). Die Bibliothek zielt auf .NET Standard 2.0, sodass jedes SDK, das auf .NET Framework 4.6.2+ oder .NET 6/8/10 abzielt, sie referenzieren kann.

Ladeprobleme

UnsupportedFileFormatException beim Laden eines Dokuments

UnsupportedFileFormatException wird beim Laden ausgelöst, wenn das Dateiformat nicht erkannt wird oder von dieser Edition nicht unterstützt wird. Die Ladeformate dieser Edition sind DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown und Nur-Text — das Übergeben eines nicht unterstützten Pfads wie input.doc an den Document-Konstruktor löst diese Ausnahme aus, anstatt ein geladenes Dokument zurückzugeben:

using Aspose.Words;

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

Das Abfangen von UnsupportedFileFormatException um den Document-Konstruktor ermöglicht es Ihnen, eine klare Meldung zu berichten, anstatt die Ausnahme als rohen Stack-Trace weiterzuleiten.

FileCorruptedException bei einer Datei, die gültig aussieht

FileCorruptedException wird beim Laden ausgelöst, wenn die Datei beschädigt zu sein scheint und nicht geparst werden kann — zum Beispiel eine .docx-Datei, die kein gültiges ZIP-basiertes OOXML-Paket ist, oder eine Datei, die beim Transfer abgeschnitten wurde. Beschaffen Sie die Datei erneut von ihrer Quelle und stellen Sie sicher, dass sie sich korrekt öffnen lässt, bevor Sie sie mit Document laden.

IncorrectPasswordException beim Öffnen eines geschützten Dokuments

Dies wird ausgelöst, wenn ein Dokument mit einem Passwort verschlüsselt ist und das dem Konstruktor von Document übergebene LoadOptions-Überladung fehlt oder falsch ist. Geben Sie das korrekte Passwort über LoadOptions.Password ein, bevor Sie das Dokument laden.

Speicher- und Exportprobleme

Document.Save() zu einer PDF-, XPS- oder Bild-Erweiterung schlägt fehl

Diese Edition enthält das Seitenlayout- und Rendering-Subsystem nicht, daher kann Document.Save() nicht in PDF-, XPS- oder Bildformate exportieren.

Speichern Sie stattdessen im DOCX-, DOCM-, DOTX-, DOTM-, Flat OPC-, Markdown- oder Nur-Text-Format — das sind die Formate, die diese Ausgabe tatsächlich schreibt. Die kommerzielle Aspose.Words für .NET fügt PDF-, XPS- und Bildausgabe hinzu.

Seitennummern und Einträge im Inhaltsverzeichnis zeigen immer 0 an

Aspose.Words FOSS für .NET enthält eine vollständige Feldauswertungs-Engine, sodass Inhaltsfelder wie DATE und DOCPROPERTY korrekt aktualisiert werden. Felder, die vom Seitenlayout abhängen – Seitenzahlen, NUMPAGES und Inhaltsverzeichnis-Einträge – werden zu einem Platzhalter 0 ausgewertet anstatt zu einem berechneten Wert, weil diese Ausgabe nicht die Layout-Engine enthält, die normalerweise das Dokument paginiert. Dieses Verhalten ist in dieser Ausgabe erwartungsgemäß und kein Fehler.

Probleme mit digitalen Signaturen

Das Signieren eines Dokuments hat keine Wirkung

DigitalSignatureUtil.Sign() und die zugehörigen Signatur-APIs existieren im Objektmodell zur strukturellen Kompatibilität mit dem kommerziellen Produkt, aber das Erstellen einer neuen Signatur ist in dieser FOSS-Ausgabe nicht funktionsfähig – ein Aufruf erzeugt keine signierte Ausgabe. Diese Ausgabe kann Signaturen, die bereits an ein Dokument angehängt sind, über Document.DigitalSignatures und DigitalSignatureUtil.LoadSignatures() inspizieren und verifizieren, aber ein Signatur-Workflow erfordert das kommerzielle Aspose.Words für .NET.

Schriftarten-Probleme

Eingebettete Schriftarten sind größer als erwartet

Wenn EmbedTrueTypeFonts aktiviert ist, werden Schriftarten als ganze Dateien eingebettet, anstatt nur die tatsächlich im Dokument verwendeten Glyphen zu subsetten, sodass gespeicherte Dateien, die Schriftarten einbetten, größer sind als das entsprechende Ergebnis des kommerziellen Produkts. Es gibt in dieser Ausgabe keinen Workaround – das Subsetten eingebetteter Schriftarten ist nicht enthalten.