Class IronPdfUnsupportedException

Thrown when attempting to use features not supported in the current environment or configuration. Common causes include platform limitations, missing dependencies, or deprecated functionality.

try {
    // Attempt operation that may not be supported:
    pdf.SignWithTimestamp(signature, timestampServer);
}
catch (IronPdfUnsupportedException ex) {
    // Handle unsupported feature gracefully:
    Console.WriteLine($"Feature not available: {ex.Message}");
    // Fall back to alternative:
    pdf.Sign(signature);  // Sign without timestamp
}

// Check platform before attempting:
if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux)) {
    // Some features may not be available on Linux
    Console.WriteLine("Limited features on Linux");
}

Check documentation for platform-specific limitations

Consider fallback options for unsupported features

See: https://ironpdf.com/troubleshooting/unsupported-features/

Inheritance
System.Object
IronPdfUnsupportedException
Namespace: IronPdf.Exceptions
Assembly: IronPdf.dll
Syntax
public class IronPdfUnsupportedException : Exception
Remarks

Common Scenarios:

Advanced Error Handling: 

// Comprehensive error handling with logging:
public async Task<PdfDocument> ProcessPdfSafely(string path) {
 try {
     var pdf = PdfDocument.FromFile(path);

 // Try advanced feature:
 try {
     pdf.OptimizeForWeb();
 }
 catch (IronPdfUnsupportedException ex) {
     _logger.LogWarning($&quot;Web optimization not supported: {ex.Message}&quot;);
     // Continue without optimization
 }

 // Try platform-specific feature:
 if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) {
     try {
         pdf.Print();
     }
     catch (IronPdfUnsupportedException) {
         _logger.LogInfo(&quot;Direct printing not available&quot;);
     }
 }

 return pdf;



}
catch (Exception ex) {
_logger.LogError($"PDF processing failed: {ex}");
throw;
}
}


// Feature detection pattern:
public static class FeatureDetector {
public static bool SupportsOCR() {
try {
// Test OCR capability
var test = new PdfOcrReader();
return true;
}
catch (IronPdfUnsupportedException) {
return false;
}
}
}

Constructors

IronPdfUnsupportedException()

Declaration
public IronPdfUnsupportedException()

IronPdfUnsupportedException(String)

Declaration
public IronPdfUnsupportedException(string message)
Parameters
Type Name Description
System.String message

IronPdfUnsupportedException(String, Exception)

Declaration
public IronPdfUnsupportedException(string message, Exception innerException)
Parameters
Type Name Description
System.String message
System.Exception innerException