Update content 2026-10-30 19:48:07

Author: nikola-yankov

english/net/_index.md

@@ -5,7 +5,7 @@ weight: 10
 url: /net/
 description: GroupDocs.Conversion for .NET API References contain examples, code snippets, and API documentation. It provides namespaces, classes, interfaces, and other API details.
 is_root: true
-version: "26.9"
+version: "26.10"
 ---
 
 ## Namespaces

english/net/groupdocs.conversion.caching/filecache/set/_index.md

@@ -19,6 +19,12 @@ public void Set(string key, object value)
 | key | String | A unique identifier for the cache entry. |
 | value | Object | The object to insert. |
 
+### Exceptions
+
+| exception | condition |
+| --- | --- |
+| ArgumentException | The key is null, empty, rooted or contains path separators or parent-directory segments. |
+
 ### See Also
 
 * class [FileCache](../../filecache)

english/net/groupdocs.conversion.caching/filecache/trygetvalue/_index.md

@@ -27,6 +27,12 @@ True
 
 if the key was found.
 
+### Exceptions
+
+| exception | condition |
+| --- | --- |
+| ArgumentException | The key is null, empty, rooted or contains path separators or parent-directory segments. |
+
 ### See Also
 
 * class [FileCache](../../filecache)

english/net/groupdocs.conversion.options.load/_index.md

@@ -26,6 +26,7 @@ The namespace provides classes to specify additional options for document loadin
 | [EmailField](./emailfield) | Describes email fields enumeration |
 | [EmailLoadOptions](./emailloadoptions) | Options for loading Email documents. |
 | [EpubLoadOptions](./epubloadoptions) | Options for loading Epub documents. |
+| [ExternalResourceLoadingArgs](./externalresourceloadingargs) | Describes a resource passed to [`OnLoading`](../groupdocs.conversion.options.load/iexternalresourcehandler/onloading). |
 | [FinanceLoadOptions](./financeloadoptions) | Options for loading finance documents. |
 | [FontLoadOptions](./fontloadoptions) | Options for loading Font documents. |
 | [GisLoadOptions](./gisloadoptions) | Options for loading GIS documents. |
@@ -69,11 +70,12 @@ The namespace provides classes to specify additional options for document loadin
 | Interface | Description |
 | --- | --- |
 | [ICustomCssStyleOptions](./icustomcssstyleoptions) | Represents options for custom CSS styling during document conversion |
+| [IExternalResourceHandler](./iexternalresourcehandler) | Decides, for each resource a document asks an engine to load, whether it is loaded, skipped or supplied. |
 | [IFontSubstituteLoadOptions](./ifontsubstituteloadoptions) | Options for loading documents with font substitutes. |
 | [IFontTransformationLoadOptions](./ifonttransformationloadoptions) | Options for loading documents with font transformations. Font transformations occur after document loading and font substitution are complete. |
 | [IMetadataLoadOptions](./imetadataloadoptions) | Options to control metadata in the converted document. |
 | [IPageLayoutOptions](./ipagelayoutoptions) | Options to control page layout scaling when loading documents. |
 | [IPageNumberingLoadOptions](./ipagenumberingloadoptions) | Options to control page numbering in the converted document. |
-| [IResourceLoadingOptions](./iresourceloadingoptions) | Represents set of options to control how external resources will be loaded |
+| [IResourceLoadingOptions](./iresourceloadingoptions) | Represents the options that control which external resources a document may load. |
 
 <!-- DO NOT EDIT: generated by xmldocmd for GroupDocs.conversion.dll -->

english/net/groupdocs.conversion.options.load/csvloadoptions/_index.md

@@ -39,6 +39,7 @@ public sealed class CsvLoadOptions : SpreadsheetLoadOptions
 | [DefaultFont](../../groupdocs.conversion.options.load/spreadsheetloadoptions/defaultfont) { get; set; } | Default font for spreadsheet document. The following font will be used if a font is missing. |
 | [Depth](../../groupdocs.conversion.options.load/spreadsheetloadoptions/depth) { get; set; } | Implements [`Depth`](../../groupdocs.conversion.contracts/idocumentscontainerloadoptions/depth) Default: 1 |
 | [Encoding](../../groupdocs.conversion.options.load/csvloadoptions/encoding) { get; set; } | Encoding. Default is Encoding.Default. |
+| [ExternalResourceHandler](../../groupdocs.conversion.options.load/spreadsheetloadoptions/externalresourcehandler) { get; set; } | Gets or sets the handler called for each resource the document asks an engine to load. Default: `null`. |
 | [FontSubstitutes](../../groupdocs.conversion.options.load/spreadsheetloadoptions/fontsubstitutes) { get; set; } | Substitute specific fonts when converting spreadsheet document. |
 | [Format](../../groupdocs.conversion.options.load/csvloadoptions/format) { get; } | Input document file type. |
 | virtual [Format](../../groupdocs.conversion.options.load/loadoptions/format) { get; } | Input document file type. |
@@ -60,10 +61,10 @@ public sealed class CsvLoadOptions : SpreadsheetLoadOptions
 | [ShowHiddenSheets](../../groupdocs.conversion.options.load/spreadsheetloadoptions/showhiddensheets) { get; set; } | Show hidden sheets when converting Excel files. |
 | [SizeSettings](../../groupdocs.conversion.options.load/spreadsheetloadoptions/sizesettings) { get; set; } | Page size settings |
 | [SkipEmptyRowsAndColumns](../../groupdocs.conversion.options.load/spreadsheetloadoptions/skipemptyrowsandcolumns) { get; set; } | Skips empty rows and columns when converting. Default is True. |
-| [SkipExternalResources](../../groupdocs.conversion.options.load/spreadsheetloadoptions/skipexternalresources) { get; set; } | Implements [`SkipExternalResources`](../iresourceloadingoptions/skipexternalresources) |
+| [SkipExternalResources](../../groupdocs.conversion.options.load/spreadsheetloadoptions/skipexternalresources) { get; set; } | Gets or sets whether external resources are denied. Default: `true`. |
 | [SkipFooters](../../groupdocs.conversion.options.load/spreadsheetloadoptions/skipfooters) { get; set; } | Skip footers when converting spreadsheet documents. Default: false. |
 | [SkipHeaders](../../groupdocs.conversion.options.load/spreadsheetloadoptions/skipheaders) { get; set; } | Skip headers when converting spreadsheet documents. Default: false. |
-| [WhitelistedResources](../../groupdocs.conversion.options.load/spreadsheetloadoptions/whitelistedresources) { get; set; } | Implements [`WhitelistedResources`](../iresourceloadingoptions/whitelistedresources) |
+| [WhitelistedResources](../../groupdocs.conversion.options.load/spreadsheetloadoptions/whitelistedresources) { get; set; } | Gets or sets the absolute URI prefixes of the external resources that load while [`SkipExternalResources`](../spreadsheetloadoptions/skipexternalresources) is `true`. |
 
 ## Methods
 

english/net/groupdocs.conversion.options.load/emailloadoptions/_index.md

@@ -41,6 +41,7 @@ public sealed class EmailLoadOptions : LoadOptions, ICustomCssStyleOptions,
 | [DisplaySent](../../groupdocs.conversion.options.load/emailloadoptions/displaysent) { get; set; } | Option to display or hide sent date/time in the header. Default: true. |
 | [DisplaySubject](../../groupdocs.conversion.options.load/emailloadoptions/displaysubject) { get; set; } | Option to display or hide subject in the header. Default: true. |
 | [DisplayToEmailAddress](../../groupdocs.conversion.options.load/emailloadoptions/displaytoemailaddress) { get; set; } | Option to display or hide "to" email address. Default: true. |
+| [ExternalResourceHandler](../../groupdocs.conversion.options.load/emailloadoptions/externalresourcehandler) { get; set; } | Gets or sets the handler called for each resource the document asks an engine to load. Default: `null`. |
 | [FieldTextMap](../../groupdocs.conversion.options.load/emailloadoptions/fieldtextmap) { get; set; } | The mapping between email message [`EmailField`](../emailfield) and field text representation |
 | [FontSubstitutes](../../groupdocs.conversion.options.load/emailloadoptions/fontsubstitutes) { get; set; } | List of font substitutes. |
 | [Format](../../groupdocs.conversion.options.load/emailloadoptions/format) { get; set; } | Input document file type. Is `null` until a format has been set, so test it for `null` rather than against [`Unknown`](../../groupdocs.conversion.filetypes/filetype/unknown), which it never equals. |
@@ -51,10 +52,10 @@ public sealed class EmailLoadOptions : LoadOptions, ICustomCssStyleOptions,
 | [PreserveOriginalDate](../../groupdocs.conversion.options.load/emailloadoptions/preserveoriginaldate) { get; set; } | Defines whether need to keep original date header string in mail message when saving or not (Default value is true) |
 | [ResourceLoadingTimeout](../../groupdocs.conversion.options.load/emailloadoptions/resourceloadingtimeout) { get; set; } | Timeout for loading external resources |
 | [SizeSettings](../../groupdocs.conversion.options.load/emailloadoptions/sizesettings) { get; set; } | Page size settings |
-| [SkipExternalResources](../../groupdocs.conversion.options.load/emailloadoptions/skipexternalresources) { get; set; } | Implements [`SkipExternalResources`](../iresourceloadingoptions/skipexternalresources) |
+| [SkipExternalResources](../../groupdocs.conversion.options.load/emailloadoptions/skipexternalresources) { get; set; } | Gets or sets whether external resources are denied. Default: `true`. |
 | [TimeZoneOffset](../../groupdocs.conversion.options.load/emailloadoptions/timezoneoffset) { get; set; } | Gets or sets the Coordinated Universal Time (UTC) offset for the message dates. This property defines the time zone difference, between the localtime and UTC. |
 | [UseDefaultAttachmentIcons](../../groupdocs.conversion.options.load/emailloadoptions/usedefaultattachmenticons) { get; set; } | Gets or sets whether to use default attachment icons. Default: true. |
-| [WhitelistedResources](../../groupdocs.conversion.options.load/emailloadoptions/whitelistedresources) { get; set; } | Implements [`WhitelistedResources`](../iresourceloadingoptions/whitelistedresources) |
+| [WhitelistedResources](../../groupdocs.conversion.options.load/emailloadoptions/whitelistedresources) { get; set; } | Gets or sets the absolute URI prefixes of the external resources that load while [`SkipExternalResources`](./skipexternalresources) is `true`. |
 
 ## Methods
 

english/net/groupdocs.conversion.options.load/emailloadoptions/clone/_index.md

@@ -3,7 +3,7 @@ title: Clone
 second_title: GroupDocs.Conversion for .NET API Reference
 description: Clones current instance.
 type: docs
-weight: 300
+weight: 310
 url: /net/groupdocs.conversion.options.load/emailloadoptions/clone/
 ---
 ## EmailLoadOptions.Clone method

english/net/groupdocs.conversion.options.load/emailloadoptions/externalresourcehandler/_index.md

@@ -0,0 +1,30 @@
+---
+title: ExternalResourceHandler
+second_title: GroupDocs.Conversion for .NET API Reference
+description: Gets or sets the handler called for each resource the document asks an engine to load. Default null.
+type: docs
+weight: 170
+url: /net/groupdocs.conversion.options.load/emailloadoptions/externalresourcehandler/
+---
+## EmailLoadOptions.ExternalResourceHandler property
+
+Gets or sets the handler called for each resource the document asks an engine to load. Default: `null`.
+
+```csharp
+public IExternalResourceHandler ExternalResourceHandler { get; set; }
+```
+
+### Remarks
+
+The handler sees the decision of [`SkipExternalResources`](../skipexternalresources) and [`WhitelistedResources`](../whitelistedresources) for each resource and can allow it, skip it or supply its content. See [`IExternalResourceHandler`](../../iexternalresourcehandler) for the rules.
+
+The handler is copied with the options and kept for every document the operation loads from them, including intermediate documents and reloads. It is not serialized with the options.
+
+### See Also
+
+* interface [IExternalResourceHandler](../../iexternalresourcehandler)
+* class [EmailLoadOptions](../../emailloadoptions)
+* namespace [GroupDocs.Conversion.Options.Load](../../../groupdocs.conversion.options.load)
+* assembly [GroupDocs.Conversion](../../../)
+
+<!-- DO NOT EDIT: generated by xmldocmd for GroupDocs.conversion.dll -->

english/net/groupdocs.conversion.options.load/emailloadoptions/fieldtextmap/_index.md

@@ -3,7 +3,7 @@ title: FieldTextMap
 second_title: GroupDocs.Conversion for .NET API Reference
 description: The mapping between email message EmailFieldgroupdocs.conversion.options.load/emailfield and field text representation
 type: docs
-weight: 170
+weight: 180
 url: /net/groupdocs.conversion.options.load/emailloadoptions/fieldtextmap/
 ---
 ## EmailLoadOptions.FieldTextMap property

english/net/groupdocs.conversion.options.load/emailloadoptions/fontsubstitutes/_index.md

@@ -3,7 +3,7 @@ title: FontSubstitutes
 second_title: GroupDocs.Conversion for .NET API Reference
 description: List of font substitutes.
 type: docs
-weight: 180
+weight: 190
 url: /net/groupdocs.conversion.options.load/emailloadoptions/fontsubstitutes/
 ---
 ## EmailLoadOptions.FontSubstitutes property