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