Skip to content

Commit 7476624

Browse files
nikola-yankovnikola-yankov
committed
ebook load options
1 parent 1d88f99 commit 7476624

1 file changed

Lines changed: 197 additions & 0 deletions

File tree

‎net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-ebook-document-with-options.md‎

Lines changed: 197 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
---
2+
id: load-ebook-document-with-options
3+
url: conversion/net/load-ebook-document-with-options
4+
title: Load EBook Documents with Options
5+
weight: 14
6+
description: "Learn how to use EBookLoadOptions to configure ebook document loading in GroupDocs.Conversion for .NET. Supports MOBI, EPUB, and AZW3 formats."
7+
keywords: EBookLoadOptions, load ebook, MOBI, EPUB, AZW3, Kindle, ebook conversion, GroupDocs.Conversion
8+
productName: GroupDocs.Conversion for .NET
9+
hideChildren: False
10+
---
11+
12+
## Introduction
13+
14+
The **EBookLoadOptions** class enables you to configure how electronic book (ebook) documents are loaded in GroupDocs.Conversion. This class supports popular ebook formats used across various reading platforms and devices.
15+
16+
EBookLoadOptions works with common ebook formats including MOBI (Kindle), EPUB (universal standard), and AZW3 (Kindle Fire).
17+
18+
## Properties
19+
20+
| Property | Type | Description |
21+
|----------|------|-------------|
22+
| `Format` | `EBookFileType` | The input ebook format (read-only; get;) |
23+
24+
## Basic Usage
25+
26+
For most scenarios, GroupDocs.Conversion automatically detects the ebook format:
27+
28+
```csharp
29+
using (var converter = new Converter("digital-novel.mobi"))
30+
{
31+
converter.Convert("digital-novel.pdf", new PdfConvertOptions());
32+
}
33+
```
34+
35+
## Using EBookLoadOptions with LoadContext
36+
37+
When you need explicit control over loading behavior, use EBookLoadOptions with the LoadContext delegate pattern:
38+
39+
```csharp
40+
using (var converter = new Converter(
41+
"technical-manual.epub",
42+
(LoadContext loadContext) => new EBookLoadOptions()))
43+
{
44+
converter.Convert("technical-manual.pdf", new PdfConvertOptions());
45+
}
46+
```
47+
48+
## Common Conversion Scenarios
49+
50+
### EBook to PDF
51+
52+
Convert ebooks to PDF for universal compatibility and printing:
53+
54+
```csharp
55+
using (var converter = new Converter(
56+
"cookbook-recipes.mobi",
57+
(LoadContext loadContext) => new EBookLoadOptions()))
58+
{
59+
converter.Convert("cookbook-recipes.pdf", new PdfConvertOptions());
60+
}
61+
```
62+
63+
### EBook to Word Document
64+
65+
Convert ebooks to editable Word documents:
66+
67+
```csharp
68+
using (var converter = new Converter(
69+
"travel-guide.epub",
70+
(LoadContext loadContext) => new EBookLoadOptions()))
71+
{
72+
converter.Convert("travel-guide.docx", new WordProcessingConvertOptions());
73+
}
74+
```
75+
76+
### EBook to HTML
77+
78+
Convert ebooks to web-friendly HTML format:
79+
80+
```csharp
81+
using (var converter = new Converter(
82+
"reference-book.azw3",
83+
(LoadContext loadContext) => new EBookLoadOptions()))
84+
{
85+
converter.Convert("reference-book.html", new WebConvertOptions());
86+
}
87+
```
88+
89+
## Working with Different EBook Formats
90+
91+
GroupDocs.Conversion supports multiple ebook formats through EBookLoadOptions:
92+
93+
### MOBI (Mobipocket)
94+
95+
MOBI is a widely-used format, especially for Amazon Kindle devices:
96+
97+
```csharp
98+
using (var converter = new Converter(
99+
"mystery-novel.mobi",
100+
(LoadContext loadContext) => new EBookLoadOptions()))
101+
{
102+
converter.Convert("mystery-novel.pdf", new PdfConvertOptions());
103+
}
104+
```
105+
106+
### EPUB (Electronic Publication)
107+
108+
EPUB is an open standard format supported by most ebook readers:
109+
110+
```csharp
111+
using (var converter = new Converter(
112+
"user-manual.epub",
113+
(LoadContext loadContext) => new EBookLoadOptions()))
114+
{
115+
converter.Convert("user-manual.docx", new WordProcessingConvertOptions());
116+
}
117+
```
118+
119+
### AZW3 (Kindle Format 8)
120+
121+
AZW3 is Amazon's modern ebook format with enhanced features:
122+
123+
```csharp
124+
using (var converter = new Converter(
125+
"reference-book.azw3",
126+
(LoadContext loadContext) => new EBookLoadOptions()))
127+
{
128+
converter.Convert("reference-book.html", new WebConvertOptions());
129+
}
130+
```
131+
132+
## Supported EBook Formats
133+
134+
EBookLoadOptions works with:
135+
- **MOBI** - Mobipocket format (Amazon Kindle)
136+
- **EPUB** - Electronic Publication (universal standard)
137+
- **AZW3** - Kindle Format 8 (Kindle Fire and newer devices)
138+
139+
## Common Use Cases
140+
141+
Use EBookLoadOptions when you need to:
142+
143+
1. **Convert digital publications** - Transform ebooks into formats suitable for different platforms
144+
2. **Create printable versions** - Convert ebooks to PDF for physical printing
145+
3. **Extract content** - Convert ebooks to Word or HTML for editing and content reuse
146+
4. **Cross-platform compatibility** - Convert between different ebook formats (EPUB to MOBI, etc.)
147+
5. **Publishing workflows** - Integrate ebook conversion into digital publishing pipelines
148+
149+
## When to Use EBookLoadOptions
150+
151+
Use EBookLoadOptions when:
152+
153+
- Working with electronic book formats (MOBI, EPUB, AZW3)
154+
- Converting digital publications to other formats
155+
- Building ebook management or publishing systems
156+
- Creating multi-format output from ebook sources
157+
- You need explicit control over ebook document loading
158+
159+
## Without EBookLoadOptions
160+
161+
For simple conversions, you can rely on automatic format detection:
162+
163+
```csharp
164+
using (var converter = new Converter("digital-novel.mobi"))
165+
{
166+
converter.Convert("digital-novel.pdf", new PdfConvertOptions());
167+
}
168+
```
169+
170+
GroupDocs.Conversion automatically detects the ebook format in most cases, so EBookLoadOptions is optional unless you need specific loading configuration.
171+
172+
## Output Format Compatibility
173+
174+
EBooks can be converted to various output formats:
175+
176+
- **Document formats**: PDF, DOCX, RTF, TXT
177+
- **Web formats**: HTML, MHTML
178+
- **Spreadsheet formats**: XLSX, XLS
179+
- **Presentation formats**: PPTX, PPT
180+
- **Other ebook formats**: EPUB, MOBI, AZW3
181+
182+
**Note**: Image formats (PNG, JPG) require page-by-page conversion using SavePageContext since ebooks are multi-page documents.
183+
184+
## Summary
185+
186+
EBookLoadOptions provides control over electronic book document loading:
187+
- **Format**: Read-only property indicating the ebook format
188+
- **Supports**: MOBI, EPUB, AZW3 formats
189+
- **Use Case**: Digital publishing, cross-platform ebook conversion, content extraction
190+
191+
All examples on this page have been verified through automated testing to ensure accuracy.
192+
193+
## See Also
194+
195+
- [Context Objects - Complete Guide]({{< ref "conversion/net/developer-guide/basic-usage/context-objects-complete-guide" >}})
196+
- [EBookFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/ebookfiletype/)
197+
- [EBookLoadOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/ebookloadoptions/)

0 commit comments

Comments
 (0)