समस्या निवारण 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-FOSS-for-.NET/Aspose.Words/ फ़ोल्डर के भीतर Aspose.Words.csproj की ओर इशारा करता है, और समाधान पहले सफलतापूर्वक बना है (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, और plain text — 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);
}

Document कंस्ट्रक्टर के आसपास UnsupportedFileFormatException को पकड़ने से आप एक स्पष्ट संदेश रिपोर्ट कर सकते हैं, बजाय इसके कि अपवाद कच्चे स्टैक ट्रेस के रूप में प्रसारित हो।

वैध दिखने वाली फ़ाइल पर FileCorruptedException

FileCorruptedException लोड के दौरान फेंका जाता है जब फ़ाइल खराब लगती है और पार्स नहीं की जा सकती — उदाहरण के लिए, एक .docx फ़ाइल जो वैध ZIP-आधारित OOXML पैकेज नहीं है, या ट्रांसफ़र के दौरान काटी गई फ़ाइल। फ़ाइल को उसके स्रोत से पुनः प्राप्त करें और Document के साथ लोड करने से पहले पुष्टि करें कि यह सही ढंग से खुलती है।

IncorrectPasswordException जब एक सुरक्षित दस्तावेज़ खोला जाता है

यह तब फेंका जाता है जब कोई दस्तावेज़ पासवर्ड से एन्क्रिप्ट किया गया हो और Document कंस्ट्रक्टर के LoadOptions ओवरलोड को दिया गया पासवर्ड अनुपलब्ध या गलत हो। लोड करने से पहले LoadOptions.Password के माध्यम से सही पासवर्ड प्रदान करें।

सहेजना और निर्यात समस्याएँ

Document.Save() को PDF, XPS, या इमेज एक्सटेंशन में निर्यात करना विफल रहता है

इस संस्करण में पेज-लेआउट और रेंडरिंग सबसिस्टम शामिल नहीं है, इसलिए Document.Save() PDF, XPS, या इमेज फ़ॉर्मैट में निर्यात नहीं कर सकता।

DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, या plain text में सहेजें — ये वे फ़ॉर्मेट हैं जिन्हें यह संस्करण वास्तव में लिखता है। वाणिज्यिक Aspose.Words के लिए .NET PDF, XPS, और इमेज आउटपुट जोड़ता है।

पृष्ठ क्रमांक और तालिका-ऑफ़-कंटेंट्स प्रविष्टियाँ हमेशा 0 दिखाती हैं

Aspose.Words FOSS for .NET में एक पूर्ण फ़ील्ड मूल्यांकन इंजन शामिल है, इसलिए DATE और DOCPROPERTY जैसे कंटेंट फ़ील्ड सही ढंग से अपडेट होते हैं। पेज लेआउट पर निर्भर फ़ील्ड — पेज नंबर, NUMPAGES, और TOC एंट्रीज़ — एक प्लेसहोल्डर 0 के रूप में मूल्यित होते हैं, गणना किए गए मान की बजाय, क्योंकि इस संस्करण में वह लेआउट इंजन नहीं है जो सामान्यतः दस्तावेज़ को पेजिनेट करता है। यह इस संस्करण में अपेक्षित व्यवहार है, बग नहीं है।

डिजिटल सिग्नेचर समस्याएँ

दस्तावेज़ पर हस्ताक्षर करने से कोई प्रभाव नहीं पड़ता

DigitalSignatureUtil.Sign() और संबंधित साइनिंग API ऑब्जेक्ट मॉडल में व्यावसायिक उत्पाद के साथ संरचनात्मक संगतता के लिए मौजूद हैं, लेकिन इस FOSS संस्करण में नया सिग्नेचर बनाना कार्यात्मक नहीं है — उन्हें कॉल करने से साइन किया गया आउटपुट नहीं मिलता। यह संस्करण Document.DigitalSignatures और DigitalSignatureUtil.LoadSignatures() के माध्यम से दस्तावेज़ में पहले से जुड़े सिग्नेचर की जाँच और सत्यापन कर सकता है, लेकिन साइनिंग वर्कफ़्लो के लिए .NET हेतु व्यावसायिक Aspose.Words आवश्यक है।

फ़ॉन्ट समस्याएँ

एम्बेडेड फ़ॉन्ट अपेक्षा से बड़े हैं

जब EmbedTrueTypeFonts सक्षम होता है, तो फ़ॉन्ट पूरे फ़ाइलों के रूप में एम्बेड किए जाते हैं, न कि केवल दस्तावेज़ में वास्तव में उपयोग किए गए ग्लिफ़्स तक सीमित किए जाते हैं, इसलिए फ़ॉन्ट एम्बेड करने वाली सहेजी गई फ़ाइलें व्यावसायिक उत्पाद के समकक्ष आउटपुट की तुलना में बड़ी होती हैं। इस संस्करण में कोई वर्कअराउंड नहीं है — एम्बेडेड-फ़ॉन्ट सबसेटिंग शामिल नहीं है।