Αντιμετώπιση προβλημάτων Aspose.Words FOSS for .NET

Αυτή η σελίδα καλύπτει τα κοινά προβλήματα που προκύπτουν κατά τη δημιουργία και χρήση του Aspose.Words FOSS για .NET, καθώς και πώς να τα επιλύσετε.

Προβλήματα Κατασκευής και Εγκατάστασης

dotnet add package Aspose.Words δεν μπορεί να εντοπίσει το πακέτο

Αυτή η εντολή αντιστοιχεί στο εμπορικό πακέτο Aspose.Words, όχι στην έκδοση FOSS — το αναγνωριστικό του πακέτου FOSS είναι Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Εναλλακτικά, εκτελέστε git clone για να λάβετε τον πηγαίο κώδικα, στη συνέχεια cd στον κλωνοποιημένο φάκελο και εκτελέστε dotnet build στη λύση:

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

Στη συνέχεια, προσθέστε μια αναφορά έργου στο Aspose.Words.csproj από τη δική σας εφαρμογή αντί για μια αναφορά πακέτου.

Η αναφορά έργου δεν επιλύεται μετά την κλωνοποίηση.

Επιβεβαιώστε ότι η αναφορά δείχνει στο Aspose.Words.csproj μέσα στο κλωνοποιημένο φάκελο Aspose.Words-FOSS-for-.NET/Aspose.Words/, και ότι η λύση δημιουργήθηκε επιτυχώς πρώτα (dotnet build Aspose.Words.sln -c Release). Η βιβλιοθήκη στοχεύει το .NET Standard 2.0, έτσι οποιοδήποτε SDK που στοχεύει το .NET Framework 4.6.2+ ή το .NET 6/8/10 μπορεί να το αναφερθεί.

Προβλήματα Φόρτωσης

UnsupportedFileFormatException κατά τη φόρτωση ενός εγγράφου

UnsupportedFileFormatException εκτοξεύεται κατά τη φόρτωση όταν η μορφή αρχείου δεν αναγνωρίζεται ή δεν υποστηρίζεται από αυτή την έκδοση. Οι φορτιζόμενες μορφές αυτής της έκδοσης είναι DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown και απλό κείμενο — η παροχή μιας μη υποστηριζόμενης διαδρομής όπως input.doc στον κατασκευαστή Document προκαλεί αυτήν την εξαίρεση αντί να επιστρέφει ένα φορτωμένο έγγραφο:

using Aspose.Words;

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

Η σύλληψη του UnsupportedFileFormatException γύρω από τον κατασκευαστή Document σας επιτρέπει να αναφέρετε ένα σαφές μήνυμα αντί να αφήσετε την εξαίρεση να διαδοθεί ως ακατέργαστο stack trace.

FileCorruptedException σε ένα αρχείο που φαίνεται έγκυρο

FileCorruptedException εκτοξεύεται κατά τη φόρτωση όταν το αρχείο φαίνεται κατεστραμμένο και δεν μπορεί να αναλυθεί — για παράδειγμα, ένα αρχείο .docx που δεν είναι έγκυρο πακέτο OOXML βασισμένο σε ZIP, ή ένα αρχείο που έχει περικοπεί κατά τη μεταφορά. Αποκτήστε ξανά το αρχείο από την πηγή του και βεβαιωθείτε ότι ανοίγει σωστά πριν το φορτώσετε με Document.

IncorrectPasswordException κατά το άνοιγμα προστατευμένου εγγράφου

Αυτό εκτοξεύεται όταν ένα έγγραφο είναι κρυπτογραφημένο με κωδικό πρόσβασης και ο κωδικός που δόθηκε στον κατασκευαστή Document στην υπερφόρτωση LoadOptions λείπει ή είναι λανθασμένος. Παρέχετε τον σωστό κωδικό μέσω LoadOptions.Password πριν το φορτώσετε.

Προβλήματα Αποθήκευσης και Εξαγωγής

Αποτυχία Document.Save() σε PDF, XPS ή επέκταση εικόνας

Αυτή η έκδοση δεν περιλαμβάνει το υποσύστημα διάταξης σελίδας και απόδοσης, επομένως το Document.Save() δεν μπορεί να εξάγει σε PDF, XPS ή μορφές εικόνας.

Αποθηκεύστε σε DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown ή απλό κείμενο αντ’ αυτού — αυτά είναι οι μορφές που αυτή η έκδοση γράφει πραγματικά. Το εμπορικό Aspose.Words για .NET προσθέτει PDF, XPS και έξοδο εικόνας.

Οι αριθμοί σελίδων και οι καταχωρίσεις του πίνακα περιεχομένων εμφανίζουν πάντα 0

Aspose.Words FOSS για .NET περιλαμβάνει μια πλήρη μηχανή αξιολόγησης πεδίων, ώστε τα πεδία περιεχομένου όπως DATE και DOCPROPERTY να ενημερώνονται σωστά. Τα πεδία που εξαρτώνται από τη διάταξη της σελίδας — αριθμοί σελίδων, NUMPAGES, και καταχωρίσεις TOC — αξιολογούνται σε έναν placeholder 0 αντί για υπολογιζόμενη τιμή, επειδή αυτή η έκδοση δεν περιλαμβάνει τη μηχανή διάταξης που θα παγιώνει κανονικά το έγγραφο. Αυτό είναι η αναμενόμενη συμπεριφορά σε αυτήν την έκδοση, όχι σφάλμα.

Προβλήματα Ψηφιακής Υπογραφής

Η υπογραφή ενός εγγράφου δεν έχει κανένα αποτέλεσμα

DigitalSignatureUtil.Sign() και τα σχετιζόμενα APIs υπογραφής υπάρχουν στο μοντέλο αντικειμένων για δομική συμβατότητα με το εμπορικό προϊόν, αλλά η δημιουργία νέας υπογραφής δεν είναι λειτουργική σε αυτήν την έκδοση FOSS — η κλήση τους δεν παράγει υπογεγραμμένο αποτέλεσμα. Αυτή η έκδοση μπορεί να εξετάσει και να επαληθεύσει υπογραφές που έχουν ήδη προσαρτηθεί σε ένα έγγραφο μέσω Document.DigitalSignatures και DigitalSignatureUtil.LoadSignatures(), αλλά μια ροή εργασίας υπογραφής απαιτεί το εμπορικό Aspose.Words για .NET.

Προβλήματα Γραμματοσειρών

Οι ενσωματωμένες γραμματοσειρές είναι μεγαλύτερες από το αναμενόμενο

Όταν το EmbedTrueTypeFonts είναι ενεργοποιημένο, οι γραμματοσειρές ενσωματώνονται ως ολόκληρα αρχεία αντί να υποσύνολα περιορίζονται μόνο στα γλύφους που χρησιμοποιούνται πραγματικά στο έγγραφο, έτσι τα αποθηκευμένα αρχεία που ενσωματώνουν γραμματοσειρές είναι μεγαλύτερα από το ισοδύναμο αποτέλεσμα του εμπορικού προϊόντος. Δεν υπάρχει λύση παρακάμπτεινσης σε αυτήν την έκδοση — η υποσυνολοποίηση ενσωματωμένων γραμματοσειρών δεν περιλαμβάνεται.