अपवाद संभालना

अपवाद प्रबंधन

यह गाइड दर्शाता है कि Aspose.PDF FOSS for .NET कैसे PdfException पर आधारित टाइप्ड एक्सेप्शन हायरार्की के माध्यम से विफलताओं को संकेत करता है, जो स्वयं System.Exception से व्युत्पन्न है, और प्रत्येक त्रुटि श्रेणी को कैसे पकड़ा जाए। लाइब्रेरी में प्रत्येक PDF-विशिष्ट अपवाद — एक खराब पासवर्ड, एक अपठनीय फ़ाइल, एक अनुपलब्ध फ़ॉन्ट, या एक अमान्य फ़ॉर्म ऑपरेशन — PdfException से व्युत्पन्न होते हैं, इसलिए केवल PdfException को पकड़ना किसी भी लाइब्रेरी-उठाए गए त्रुटि को रोकने के लिए पर्याप्त है, जबकि अधिक विशिष्ट catch ब्लॉकों से आप प्रत्येक विफलता मोड के प्रति अलग तरीके से प्रतिक्रिया दे सकते हैं।

पासवर्ड और सुरक्षा त्रुटियां

InvalidPasswordException तब फेंका जाता है जब वैध पासवर्ड प्रदान किए बिना पासवर्ड-प्रोटेक्टेड ऑपरेशन करने का प्रयास किया जाता है, जैसे गलत पासवर्ड के साथ एन्क्रिप्टेड दस्तावेज़ खोलना।

try
{
    var doc = new Document("encrypted.pdf", "wrong-password");
}
catch (InvalidPasswordException ex)
{
    Console.WriteLine($"Password rejected: {ex.Message}");
}

फ़ाइल फ़ॉर्मेट त्रुटियां

InvalidPdfFileFormatException तब फेंका जाता है जब कोई स्ट्रीम PDF के रूप में नहीं खोली जा सकती — खराब हेडर, कटे हुए फ़ाइल, या ऐसी सामग्री जो बिल्कुल भी PDF के रूप में पहचानी नहीं जाती।

try
{
    var doc = new Document("not-a-pdf.txt");
}
catch (InvalidPdfFileFormatException ex)
{
    Console.WriteLine($"Not a valid PDF: {ex.Message}");
}

फ़ॉन्ट त्रुटियां

फ़ॉन्ट-संबंधी विफलताएँ तीन अलग-अलग अपवाद प्रकारों में विभाजित होती हैं, यह इस पर निर्भर करता है कि क्या गलती हुई:

• FontNotFoundException — कोई सिस्टम फ़ॉन्ट या कस्टम-फ़ॉन्ट स्रोत अनुरोधित फ़ॉन्ट नाम से मेल नहीं खाता।
• UnsupportedFontTypeException — फ़ॉन्ट के रूप में प्रदान की गई फ़ाइल मान्य फ़ॉन्ट प्रोग्राम नहीं है।
• IncorrectFontUsageException — एक टेक्स्ट-प्रदर्शन ऑपरेटर कंटेंट स्ट्रीम में दिखाई देता है जबकि वर्तमान ग्राफ़िक्स स्टेट में कोई फ़ॉन्ट सेट नहीं है।

try
{
    var font = FontRepository.FindFont("NonexistentFont");
}
catch (FontNotFoundException ex)
{
    Console.WriteLine($"Font not found: {ex.Message}");
}

try
{
    var font = FontRepository.OpenFont("not-a-font-file.dat");
}
catch (UnsupportedFontTypeException ex)
{
    Console.WriteLine($"Unsupported font file: {ex.Message}");
}

try
{
    var extractor = new PdfExtractor(doc);
    extractor.ExtractText();
}
catch (IncorrectFontUsageException ex)
{
    Console.WriteLine($"Content stream font error: {ex.Message}");
}

टेक्स्ट निष्कर्षण त्रुटियाँ

PdfTextDecodingException तब फेंका जाता है जब टेक्स्ट सामग्री को डिकोड नहीं किया जा सकता, उदाहरण के लिए जब फ़ॉन्ट द्वारा संदर्भित एन्कोडिंग अनुपलब्ध या दोषपूर्ण हो।

try
{
    var extractor = new PdfExtractor(doc);
    extractor.GetText("output.txt");
}
catch (PdfTextDecodingException ex)
{
    Console.WriteLine($"Text decoding failed: {ex.Message}");
}

फ़ॉर्म प्रकार त्रुटियाँ

InvalidFormTypeOperationException तब फेंका जाता है जब किसी गलत.

try
{
    var form = new Form(doc);
    form.AssignXfa(xmlData);
}
catch (InvalidFormTypeOperationException ex)
{
    Console.WriteLine($"Wrong form type: {ex.Message}");
}

टिप्स और सर्वोत्तम प्रथाएँ

• सबसे विशिष्ट अपवाद प्रकार को पहले पकड़ें (उदाहरण के लिए, InvalidPasswordException) और catch (PdfException) ब्लॉक को केवल लाइब्रेरी द्वारा उठाए गए अन्य सभी मामलों के लिए एक fallback के रूप में अंत में जोड़ें।
• XFA-विशिष्ट मेथड्स को कॉल करने से पहले Form.IsXfa या Form.Type जाँचें ताकि InvalidFormTypeOperationException से बचा जा सके।
• रेंडरिंग से पहले FontRepository.FindFont के साथ फ़ॉन्ट्स खोजें ताकि लापता फ़ॉन्ट्स को स्पष्ट रूप से संभाला जा सके, बजाय केवल अपवाद हैंडलिंग पर निर्भर रहने के।
• जब कोई अप्रत्याशित PdfException आपके टॉप-लेवल हैंडलर तक पहुँचता है, तो पकड़े गए अपवाद के साथ एक CrashReportOptions बनाएँ और ex.GenerateCrashReport(options) को कॉल करें ताकि सपोर्ट अनुरोधों के लिए एक डायग्नोस्टिक रिपोर्ट कैप्चर की जा सके।
• फ़ाइल को पहले खोलने और पुनः प्रयास करने के बजाय हमेशा दस्तावेज़ पासवर्ड को Document कंस्ट्रक्टर ओवरलोड के माध्यम से पास करें।

सामान्य समस्याएँ

FAQ

क्या मुझे PdfException को पकड़ना चाहिए या विशिष्ट उपवर्ग को?

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

क्या सभी PDF-विशिष्ट अपवाद PdfException से व्युत्पन्न होते हैं?

हां। PdfTextDecodingException, IncorrectFontUsageException, InvalidPasswordException, InvalidPdfFileFormatException, FontNotFoundException, UnsupportedFontTypeException, और InvalidFormTypeOperationException सभी PdfException से व्युत्पन्न हैं, जो स्वयं System.Exception से व्युत्पन्न है।

PdfExceptionMessages किस लिए है?

PdfExceptionMessages एक स्थैतिक क्लास है जो लाइब्रेरी के अपवादों और सुरक्षा निदान द्वारा प्रदर्शित संदेश स्ट्रिंग्स को केंद्रीकृत करता है, जिसमें DangerousFile संदेश भी शामिल है।

क्या मैं कोई अपवाद होने पर एक निदान रिपोर्ट उत्पन्न कर सकता हूँ?

हां। पकड़े गए अपवाद के साथ एक CrashReportOptions इंस्टेंस बनाएं, वैकल्पिक रूप से ApplicationTitle और CrashReportDirectory जैसी प्रॉपर्टीज़ सेट करें, और विस्तृत क्रैश रिपोर्ट लिखने के लिए PdfException पर GenerateCrashReport(options) कॉल करें।

API Reference सारांश

यह भी देखें

• Aspose.PDF for .NET Enterprise Product
• Aspose.PDF for .NET — Enterprise Documentation