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 unsupported features 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