Update content 2026-11-09 02:53:16

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.10"
+version: "26.11"
 ---
 
 ## Namespaces

english/net/groupdocs.conversion.contracts/idocumentscontainerloadoptions/_index.md

@@ -20,7 +20,7 @@ public interface IDocumentsContainerLoadOptions
 | --- | --- |
 | [ConvertOwned](../../groupdocs.conversion.contracts/idocumentscontainerloadoptions/convertowned) { get; } | Option to control whether the owned documents in the documents container must be converted |
 | [ConvertOwner](../../groupdocs.conversion.contracts/idocumentscontainerloadoptions/convertowner) { get; } | Option to control whether the documents container itself must be converted If this property is true the documents container will be the first converted document |
-| [Depth](../../groupdocs.conversion.contracts/idocumentscontainerloadoptions/depth) { get; } | Option to control how many levels in depth to perform conversion |
+| [Depth](../../groupdocs.conversion.contracts/idocumentscontainerloadoptions/depth) { get; } | How many levels of contained documents the conversion goes down, counted from the document the conversion starts from, which is level 0: 0 or a negative value converts no contained document, 1 converts the documents it contains directly, 2 also the documents those contain, and so on. The Depth of the load options of the document the conversion starts from is the limit for the whole conversion. When the load options callback returns load options for a contained document at level L, their Depth limits the documents it contains to level L + Depth, never deeper than that limit; a contained document the callback returns no load options for keeps the limit of its container. |
 
 ### See Also
 

english/net/groupdocs.conversion.contracts/idocumentscontainerloadoptions/depth/_index.md

@@ -1,14 +1,14 @@
 ---
 title: Depth
 second_title: GroupDocs.Conversion for .NET API Reference
-description: Option to control how many levels in depth to perform conversion
+description: How many levels of contained documents the conversion goes down counted from the document the conversion starts from which is level 0 0 or a negative value converts no contained document 1 converts the documents it contains directly 2 also the documents those contain and so on. The Depth of the load options of the document the conversion starts from is the limit for the whole conversion. When the load options callback returns load options for a contained document at level L their Depth limits the documents it contains to level L  Depth never deeper than that limit a contained document the callback returns no load options for keeps the limit of its container.
 type: docs
 weight: 30
 url: /net/groupdocs.conversion.contracts/idocumentscontainerloadoptions/depth/
 ---
 ## IDocumentsContainerLoadOptions.Depth property
 
-Option to control how many levels in depth to perform conversion
+How many levels of contained documents the conversion goes down, counted from the document the conversion starts from, which is level 0: 0 or a negative value converts no contained document, 1 converts the documents it contains directly, 2 also the documents those contain, and so on. The Depth of the load options of the document the conversion starts from is the limit for the whole conversion. When the load options callback returns load options for a contained document at level L, their Depth limits the documents it contains to level L + Depth, never deeper than that limit; a contained document the callback returns no load options for keeps the limit of its container.
 
 ```csharp
 public int Depth { get; }

english/net/groupdocs.conversion.fluent/iconversionbypagehandlersstage/_index.md

@@ -19,7 +19,7 @@ public interface IConversionByPageHandlersStage : IConversionConvertOrCompress
 | Name | Description |
 | --- | --- |
 | [OnConversionCompleted](../../groupdocs.conversion.fluent/iconversionbypagehandlersstage/onconversioncompleted)(Action<ConvertedPageContext>) | Registers a callback to be invoked when a page conversion completes successfully. Re-invoking replaces any previously set handler. |
-| [OnConversionFailed](../../groupdocs.conversion.fluent/iconversionbypagehandlersstage/onconversionfailed)(Action<ConvertedPageContext, Exception>) | Registers a callback to be invoked when a page conversion fails. Re-invoking replaces any previously set handler. |
+| [OnConversionFailed](../../groupdocs.conversion.fluent/iconversionbypagehandlersstage/onconversionfailed)(Action<ConvertedPageContext, Exception>) | Registers a callback to be invoked when a page conversion fails. Re-invoking replaces any previously set handler. It reports the final outcome only: a document that loads after the load options provider was asked again is not reported. |
 
 ### See Also
 

english/net/groupdocs.conversion.fluent/iconversionbypagehandlersstage/onconversionfailed/_index.md

@@ -1,14 +1,14 @@
 ---
 title: OnConversionFailed
 second_title: GroupDocs.Conversion for .NET API Reference
-description: Registers a callback to be invoked when a page conversion fails. Reinvoking replaces any previously set handler.
+description: Registers a callback to be invoked when a page conversion fails. Reinvoking replaces any previously set handler. It reports the final outcome only a document that loads after the load options provider was asked again is not reported.
 type: docs
 weight: 20
 url: /net/groupdocs.conversion.fluent/iconversionbypagehandlersstage/onconversionfailed/
 ---
 ## IConversionByPageHandlersStage.OnConversionFailed method
 
-Registers a callback to be invoked when a page conversion fails. Re-invoking replaces any previously set handler.
+Registers a callback to be invoked when a page conversion fails. Re-invoking replaces any previously set handler. It reports the final outcome only: a document that loads after the load options provider was asked again is not reported.
 
 ```csharp
 public IConversionByPageHandlersStage OnConversionFailed(

english/net/groupdocs.conversion.fluent/iconversionhandlersstage/_index.md

@@ -19,7 +19,7 @@ public interface IConversionHandlersStage : IConversionConvertOrCompress
 | Name | Description |
 | --- | --- |
 | [OnConversionCompleted](../../groupdocs.conversion.fluent/iconversionhandlersstage/onconversioncompleted)(Action<ConvertedContext>) | Registers a callback to be invoked when a document conversion completes successfully. Re-invoking replaces any previously set handler. |
-| [OnConversionFailed](../../groupdocs.conversion.fluent/iconversionhandlersstage/onconversionfailed)(Action<ConvertedContext, Exception>) | Registers a callback to be invoked when a document conversion fails. Re-invoking replaces any previously set handler. |
+| [OnConversionFailed](../../groupdocs.conversion.fluent/iconversionhandlersstage/onconversionfailed)(Action<ConvertedContext, Exception>) | Registers a callback to be invoked when a document conversion fails. Re-invoking replaces any previously set handler. It reports the final outcome only: a document that loads after the load options provider was asked again is not reported. |
 
 ### See Also
 

english/net/groupdocs.conversion.fluent/iconversionhandlersstage/onconversionfailed/_index.md

@@ -1,14 +1,14 @@
 ---
 title: OnConversionFailed
 second_title: GroupDocs.Conversion for .NET API Reference
-description: Registers a callback to be invoked when a document conversion fails. Reinvoking replaces any previously set handler.
+description: Registers a callback to be invoked when a document conversion fails. Reinvoking replaces any previously set handler. It reports the final outcome only a document that loads after the load options provider was asked again is not reported.
 type: docs
 weight: 20
 url: /net/groupdocs.conversion.fluent/iconversionhandlersstage/onconversionfailed/
 ---
 ## IConversionHandlersStage.OnConversionFailed method
 
-Registers a callback to be invoked when a document conversion fails. Re-invoking replaces any previously set handler.
+Registers a callback to be invoked when a document conversion fails. Re-invoking replaces any previously set handler. It reports the final outcome only: a document that loads after the load options provider was asked again is not reported.
 
 ```csharp
 public IConversionHandlersStage OnConversionFailed(Action<ConvertedContext, Exception> onFailed)

english/net/groupdocs.conversion.fluent/iconversionloadoptions/withoptions/_index.md

@@ -16,7 +16,7 @@ public IConversionSourceDocumentLoaded WithOptions(LoadOptions loadOptions)
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| loadOptions | LoadOptions | Load options |
+| loadOptions | LoadOptions | Load options. The same options are used for every load attempt, so a document that fails to load is not loaded again; use [`WithOptions`](../withoptions) to supply other options, such as a password, after a failed attempt. |
 
 ### See Also
 
@@ -39,7 +39,7 @@ public IConversionSourceDocumentLoaded WithOptions(
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| loadOptionsProvider | Func`2 | Load options provider The load options context |
+| loadOptionsProvider | Func`2 | Load options provider. It is called once for every document that is loaded, the source document and every contained document, and [`SourceFormat`](../../../groupdocs.conversion/loadcontext/sourceformat) reports the document's format: the format its name gives, or the format its content shows when the name gives no known format or names an XML or HTML document. A format stated in the returned load options is the format the document is loaded as. When the load then fails because the document needs a password, the password is wrong, its content is damaged or its format cannot be read, the provider is called once more for that document, with [`Attempt`](../../../groupdocs.conversion/loadcontext/attempt) 2, the failure in [`LoadFailure`](../../../groupdocs.conversion/loadcontext/loadfailure) and a copy of the options that failed in [`FailedLoadOptions`](../../../groupdocs.conversion/loadcontext/failedloadoptions): options that differ from the failed ones load the document again, and `null` or equal options keep the failure. An archive entry that cannot be extracted is asked the same way, with no [`SourceStream`](../../../groupdocs.conversion/loadcontext/sourcestream) and a copy of the archive's options; a password returned in [`IPasswordLoadOptions`](../../../groupdocs.conversion.options.load/ipasswordloadoptions) extracts that entry again. The failure handlers report only the final outcome. |
 
 ### See Also
 

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

@@ -76,6 +76,7 @@ The namespace provides classes to specify additional options for document loadin
 | [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. |
+| [IPasswordLoadOptions](./ipasswordloadoptions) | Represents load options that carry the password a protected document is opened with. |
 | [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/cadloadoptions/layoutnames/_index.md

@@ -16,7 +16,7 @@ public string[] LayoutNames { get; set; }
 
 ### Remarks
 
-Not honoured when converting to PDF/UA-1. That target renders the drawing as a single tagged page, which cannot carry one sheet per selected layout, so the whole drawing is converted instead and nothing here applies to it. Every other target, PDF included, honours the selection. On those targets, names are matched exactly against the layouts the drawing carries, so a name that differs only in case is a different name. A name that matches nothing is dropped and costs the caller only that sheet; a list in which nothing matches fails the conversion with an [`InvalidLoadOptionsException`](../../../groupdocs.conversion.exceptions/invalidloadoptionsexception) naming the names that missed and the layouts the drawing does carry, rather than rendering sheets the caller did not ask for. A drawing that carries no layouts at all is exempt: there is nothing for a name to match, so none is refused.
+Not honoured when converting to PDF/UA-1. That target renders the drawing as a single tagged page, which cannot carry one sheet per selected layout, so the whole drawing is converted instead and nothing here applies to it. Every other target, PDF included, honours the selection. On those targets, names are matched exactly against the layouts the drawing carries, so a name that differs only in case is a different name. A name that matches nothing is dropped and costs the caller only that sheet; a list in which nothing matches fails the conversion with an [`InvalidLoadOptionsException`](../../../groupdocs.conversion.exceptions/invalidloadoptionsexception) naming the names that missed and the layouts the drawing does carry, rather than rendering sheets the caller did not ask for. A drawing that carries no layouts at all is exempt: there is nothing for a name to match, so none is refused. The list is checked when the drawing is loaded for its conversion. When nothing matches, the load options delegate is asked once more for that drawing, with that exception as [`LoadFailure`](../../../groupdocs.conversion/loadcontext/loadfailure); options with names that match load and convert it, and otherwise the conversion fails as described.
 
 ### See Also