PersistentRendererSettings Class

Process-level settings of the persistent HTML renderer process used when HtmlRendererMode is PersistentProcess. They apply to all the HTML conversions of the application. A change takes effect at the next conversion: the running renderer process finishes its conversions in progress and is replaced by a new one started with the current settings. A setting enabled here applies to every conversion. A conversion whose converter, HTML template, header or footer enables a setting which is not enabled here fails with an exception.

Definition

Namespace: Winnovative.Pdf.Next
Assembly: Winnovative.Pdf.Next (in Winnovative.Pdf.Next.dll) Version: 20.75.0
C#
public sealed class PersistentRendererSettings
Inheritance
Object    PersistentRendererSettings

Properties

AllowInsecureContent Allows loading insecure HTTP content in secure HTTPS pages. The default value is false
DisableSiteIsolation Disables site isolation when loading content from different sources. The default value is false
DisableWebSecurity Disables web security features such as CORS and same-origin policy. The default value is false
EnableElevatedRendering Enables the HTML renderer to inherit the elevated privileges of the application using the library when the application is running elevated on Windows. The default value is true
EnableSoftwareGpuRendering When set to true, hardware GPU rendering is disabled and software rendering is used for both general page rendering and WebGL content. When set to false, hardware GPU rendering is allowed and is further controlled by GpuRenderingEnabled and GpuCompositingEnabled. The default value is false
GpuCompositingEnabled A flag indicating if hardware GPU compositing is enabled in the HTML renderer process. This property has effect only when EnableSoftwareGpuRendering is false. Hardware WebGL rendering may require both GpuRenderingEnabled and GpuCompositingEnabled to be enabled, depending on system and driver support. The default value is false
GpuRenderingEnabled A flag indicating if hardware GPU rendering is enabled in the HTML renderer process. This property has effect only when EnableSoftwareGpuRendering is false. The default value is false
IdleTimeoutSeconds Gets or sets the number of seconds after the last conversion after which an idle persistent renderer process is stopped. The next conversion starts a new process. 0 keeps the process running until the application exits or StopPersistentRenderer is called. The default value is 300 seconds.
IgnoreCertificateErrors Ignores certificate validation errors such as expired, self-signed or invalid certificates. The default value is false
MaxConversions Gets or sets the number of conversions after which the persistent renderer process is replaced by a new one. The running conversions finish in the old process. 0 means no limit. The default value is 0.
MaxLifetimeMinutes Gets or sets the number of minutes after which the persistent renderer process is replaced by a new one. The running conversions finish in the old process. 0 means no limit. The default value is 0.
RetryAfterUnexpectedExit Gets or sets a value indicating whether a conversion in progress when the persistent renderer process exits unexpectedly is retried once on a new process. When false, the conversion fails with an exception naming the exit code. The retry repeats the request; a page requested with HTTP POST fields is posted again. The default value is true.
StartTimeoutSeconds Gets or sets the number of seconds the library waits for the persistent renderer process to start before it gives up and fails the conversion. The first start on a machine reads the engine binaries from disk and can take much longer than the following ones; on a slow disk, such as the consumption plans of the cloud providers, it can exceed a minute. The default value is 90 seconds.

Methods

Equals
(Inherited from Object)
GetHashCode
(Inherited from Object)
GetType
(Inherited from Object)
ToString
(Inherited from Object)

See Also