Zpracování výjimek

Zpracování výjimek

Tento průvodce ukazuje, jak Aspose.PDF FOSS pro .NET signalizuje selhání prostřednictvím typizované hierarchie výjimek kořeněné v PdfException, která sama dědí z System.Exception, a jak zachytit každou kategorii chyby. Každá specifická výjimka PDF v knihovně — špatné heslo, nečitelný soubor, chybějící font nebo neplatná operace formuláře — dědí z PdfException, takže zachycení pouze PdfException stačí k zachycení jakékoli chyby vyvolané knihovnou, zatímco konkrétnější bloky catch vám umožní reagovat odlišně na každý režim selhání.

Chyby hesla a zabezpečení

InvalidPasswordException je vyvolána, když je provedena operace chráněná heslem bez zadání platného hesla, například otevření šifrovaného dokumentu se špatným heslem.

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

Chyby formátu souboru

InvalidPdfFileFormatException je vyvolána, když nelze otevřít proud jako PDF — špatná hlavička, oříznutý soubor nebo obsah, který není vůbec rozpoznatelný jako PDF.

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

Chyby fontů

Selhání související s fonty spadají do tří odlišných typů výjimek, v závislosti na tom, co se pokazilo:

• FontNotFoundException — žádný systémový font ani zdroj vlastního fontu neodpovídá požadovanému názvu fontu.
• UnsupportedFontTypeException — soubor poskytnutý jako font není rozpoznatelný fontový program.
• IncorrectFontUsageException — operátor zobrazující text se objeví v datovém proudu obsahu, zatímco není v aktuálním grafickém stavu nastaven žádný font.

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}");
}

Chyby při extrakci textu

PdfTextDecodingException je vyvolána, když nelze dekódovat textový obsah, například když chybí nebo je poškozeno kódování odkazované fontem.

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

Chyby typu formuláře

InvalidFormTypeOperationException je vyvolána, když je operace provedena na nesprávném typu formuláře — například volání XFA-specifické metody na formuláři, který není založen na XFA.

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

Tipy a osvědčené postupy

• Chyťte nejspecifičtější typ výjimky jako první (například InvalidPasswordException) a přidejte konečný blok catch (PdfException) pouze jako záložní řešení pro vše ostatní, co knihovna vyvolá.
• Zkontrolujte Form.IsXfa nebo Form.Type před voláním metod specifických pro XFA, abyste se vyhnuli InvalidFormTypeOperationException.
• Vyhledejte písma pomocí FontRepository.FindFont před vykreslováním, aby chybějící písma mohla být zpracována explicitně, místo aby se spoléhalo pouze na zpracování výjimek.
• Když nečekaná PdfException dorazí do vašeho handleru na nejvyšší úrovni, vytvořte CrashReportOptions s zachycenou výjimkou a zavolejte ex.GenerateCrashReport(options) pro zachycení diagnostické zprávy pro požadavky na podporu.
• Vždy předávejte heslo dokumentu přes přetížení konstruktoru Document místo toho, abyste nejprve otevřeli soubor a pak znovu zkoušeli.

Běžné problémy

FAQ

Mám zachytit PdfException nebo konkrétní podtřídu?

Zachyťte konkrétní podtřídu, například InvalidPasswordException, když potřebujete na tuto chybu reagovat odlišně. Přidejte závěrečný blok catch (PdfException) jako záložní řešení pro jakoukoli jinou chybu vyvolanou knihovnou.

Jsou všechny výjimky specifické pro PDF odvozeny od PdfException?

Ano. PdfTextDecodingException, IncorrectFontUsageException, InvalidPasswordException, InvalidPdfFileFormatException, FontNotFoundException, UnsupportedFontTypeException a InvalidFormTypeOperationException jsou všechny odvozeny od PdfException, který sám je odvozen od System.Exception.

K čemu slouží PdfExceptionMessages?

PdfExceptionMessages je statická třída, která centralizuje řetězce zpráv zobrazované výjimkami knihovny a diagnostikou zabezpečení, včetně zprávy DangerousFile.

Mohu vytvořit diagnostickou zprávu při výskytu výjimky?

Ano. Vytvořte instanci CrashReportOptions s zachycenou výjimkou, volitelně nastavte vlastnosti jako ApplicationTitle a CrashReportDirectory a zavolejte GenerateCrashReport(options) na PdfException, abyste zapsali podrobnou hlášku o pádu.

API Reference Shrnutí

Viz také:

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