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

The IronPdfUnsupportedException class represents the error raised when attempting to use features not supported in the current environment or configuration.

It lives in the IronPdf.Exceptions namespace and extends Exception. The runtime throws it when the corresponding operation fails: invalid input, an unsupported configuration, or an error returned by the underlying library component.

Read the Message and InnerException properties to find the underlying cause.

Consult the troubleshooting guides for common platform-specific causes.

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