Class RequestContexts
Browser request contexts for defining relationship between the browser request contexts of individual renders.
Important for cookies and user preferences.
Inheritance
Namespace: IronPdf.Rendering
Assembly: IronPdf.dll
Syntax
public sealed class RequestContexts : EnumThe RequestContexts enumeration in IronPDF controls how browser state such as cookies and cache is shared across individual renders.
Part of the IronPdf.Rendering namespace, declared values are Auto, Isolated, and Global (3 total). The value is assigned to ChromePdfRenderOptions.RequestContext so that Isolated renders stay sandboxed, while Global lets sessions persist between calls to RenderHtmlAsPdf or RenderUrlAsPdf.
See cookies for typical C# usage.
Fields
Auto
Defaults to Isolated
Uses Global if the user has ever invoked IronPdf.Engines.Chrome.ChromeInterop.UnmanagedDelegates.ApplyCookies
Declaration
public const RequestContexts AutoField Value
| Type | Description |
|---|---|
| RequestContexts |
Global
Uses the global request context which is shared between all renders
Declaration
public const RequestContexts GlobalField Value
| Type | Description |
|---|---|
| RequestContexts |
Remarks
Useful in some cases for persisting certain browser states between renders
Isolated
Creates a new request context which will be isolated from previous or future renders
Declaration
public const RequestContexts IsolatedField Value
| Type | Description |
|---|---|
| RequestContexts |
Remarks
Recommended, as this will ensure this render is not affected by previous renders
value__
Declaration
public int value__Field Value
| Type | Description |
|---|---|
| System.Int32 |