Skip to content

Commit 795b402

Browse files
Merge pull request #2496 from syncfusion-content/ES-1007016-Update-supported-file-format-page
Documentation(1007016): Update Supported File format page in DocIO UG Page
2 parents b5302fd + 502a392 commit 795b402

5 files changed

Lines changed: 266 additions & 634 deletions

File tree

Document-Processing-toc.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4852,7 +4852,7 @@
48524852
<a href="/document-processing/word/word-library/net/Conversion">Working with Document Conversion</a>
48534853
<ul>
48544854
<li>
4855-
<a href="/document-processing/word/word-library/net/word-file-formats">Word File Formats</a>
4855+
<a href="/document-processing/word/word-library/net/word-file-formats">Word File Formats Conversions</a>
48564856
</li>
48574857
<li>
48584858
<a href="/document-processing/word/conversions/word-to-pdf/overview">Word to PDF</a>

Document-Processing/Word/Word-Library/NET/Support-File-Formats.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ documentation: UG
88

99
# Supported File Formats in .NET Word Library
1010

11-
Syncfusion<sup>&reg;</sup> .NET Word Library (DocIO) supports all major native file formats of Microsoft Word, such as DOC, DOCX, RTF, DOT, DOTX, DOCM, and more. It also supports conversion for major native file formats to HTML, Markdown, PDF and image.
11+
Syncfusion<sup>&reg;</sup> .NET Word Library (DocIO) supports all major native file formats of Microsoft Word, such as {{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }}, {{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-document-docx)'| markdownify }}, {{'[RTF](https://help.syncfusion.com/document-processing/word/word-library/net/rtf)'| markdownify }}, {{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-97-2003-template-dot)'| markdownify }}, {{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-template-dotx)'| markdownify }}, {{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros-docm-dotm)'| markdownify }}, and more. It also supports conversion for major native file formats to {{'[HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html)'| markdownify }}, {{'[Markdown](https://help.syncfusion.com/document-processing/word/word-library/net/convert-word-document-to-markdown-in-csharp)'| markdownify }}, {{'[PDF](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf)'| markdownify }} and {{'[image](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/word-to-image)'| markdownify }}.
1212

1313
The following table describes the supported file formats and their conversions in DocIO.
1414

@@ -19,25 +19,25 @@ The following table describes the supported file formats and their conversions i
1919
</tr>
2020
<tr>
2121
<th>
22-
DOC
22+
{{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }}
2323
</th>
2424
<th>
25-
{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/open-and-save-word-document-in-console-application#open-and-save-word-document-using-net-core-and-latest)'| markdownify }}
25+
{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-document-docx)'| markdownify }}
2626
</th>
2727
<th>
28-
Word Processing XML (2007)
28+
{{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-processing-xml-xml)'| markdownify }}
2929
</th>
3030
<th>
31-
DOT
31+
{{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-97-2003-template-dot)'| markdownify }}
3232
</th>
3333
<th>
34-
DOTX
34+
{{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-template-dotx)'| markdownify }}
3535
</th>
3636
<th>
37-
DOCM
37+
{{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros-docm-dotm)'| markdownify }}
3838
</th>
3939
<th>
40-
DOTM
40+
{{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros-docm-dotm)'| markdownify }}
4141
</th>
4242
<th>
4343
{{'[ODT](https://help.syncfusion.com/document-processing/word/word-library/net/word-to-odt)'| markdownify }}
@@ -62,7 +62,7 @@ DOTM
6262
</th>
6363
</tr>
6464
<tr>
65-
<th>DOC</th>
65+
<th>{{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }}</th>
6666
<td>Yes</td>
6767
<td>Yes</td>
6868
<td>Yes</td>
@@ -79,7 +79,7 @@ DOTM
7979
<td>Yes</td>
8080
</tr>
8181
<tr>
82-
<th>{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/open-and-save-word-document-in-console-application#open-and-save-word-document-using-net-core-and-latest)'| markdownify }}</th>
82+
<th>{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-document-docx)'| markdownify }}</th>
8383
<td>Yes</td>
8484
<td>Yes</td>
8585
<td>Yes</td>
@@ -96,7 +96,7 @@ DOTM
9696
<td>Yes</td>
9797
</tr>
9898
<tr>
99-
<th>Word Processing XML (2003)</th>
99+
<th>{{'[Word Processing XML (2003)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-processing-xml-xml)'| markdownify }}</th>
100100
<td>Yes</td>
101101
<td>Yes</td>
102102
<td>Yes</td>
@@ -113,7 +113,7 @@ DOTM
113113
<td>Yes</td>
114114
</tr>
115115
<tr>
116-
<th>Word Processing XML (2007)</th>
116+
<th>{{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-processing-xml-xml)'| markdownify }}</th>
117117
<td>Yes</td>
118118
<td>Yes</td>
119119
<td>Yes</td>
@@ -130,7 +130,7 @@ DOTM
130130
<td>Yes</td>
131131
</tr>
132132
<tr>
133-
<th>DOT</th>
133+
<th>{{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-97-2003-template-dot)'| markdownify }}</th>
134134
<td>Yes</td>
135135
<td>Yes</td>
136136
<td>Yes</td>
@@ -147,7 +147,7 @@ DOTM
147147
<td>Yes</td>
148148
</tr>
149149
<tr>
150-
<th>DOTX</th>
150+
<th>{{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-template-dotx)'| markdownify }}</th>
151151
<td>Yes</td>
152152
<td>Yes</td>
153153
<td>Yes</td>
@@ -164,7 +164,7 @@ DOTM
164164
<td>Yes</td>
165165
</tr>
166166
<tr>
167-
<th>DOCM</th>
167+
<th>{{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros-docm-dotm)'| markdownify }}</th>
168168
<td>Yes</td>
169169
<td>Yes</td>
170170
<td>Yes</td>
@@ -181,7 +181,7 @@ DOTM
181181
<td>Yes</td>
182182
</tr>
183183
<tr>
184-
<th>DOTM</th>
184+
<th>{{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros-docm-dotm)'| markdownify }}</th>
185185
<td>Yes</td>
186186
<td>Yes</td>
187187
<td>Yes</td>

Document-Processing/Word/Word-Library/NET/Working-With-OLE-Objects.md

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ platform: document-processing
55
control: DocIO
66
documentation: UG
77
---
8-
# Working with OLE Objects
8+
# Working with OLE Objects in Word Library
99

1010
OLE (Object Linking and Embedding) objects allow embedding and linking to documents and other objects. It allows the content of one program to be used in a Word document. The Objects can be inserted in the following two ways:
1111

@@ -480,6 +480,64 @@ End Sub
480480

481481
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Remove-ole-object).
482482

483+
### Preserve embedded Ole image as normal image
484+
485+
Essential<sup>&reg;</sup> DocIO keeps the entire document contents (paragraphs, images, tables and all other supported items along with the formatting) in main memory. So, there is a chance for "Out of memory exception" when the memory utilization exceeds the maximum level. For further information, please refer [here](https://support.syncfusion.com/kb/article/3998/why-does-out-of-memory-exception-arise-on-processing-large-size-documents-in-essential).
486+
487+
You can reduce the memory usage in DocIO DOM when the Word document has embedded Ole image of large file size. You can preserve these embedded Ole images as normal images by setting [PreserveOleImageAsImage](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.Settings.html#Syncfusion_DocIO_DLS_Settings_PreserveOleImageAsImage) property of Settings class as true, before opening the Word document.
488+
489+
If [PreserveOleImageAsImage](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.Settings.html#Syncfusion_DocIO_DLS_Settings_PreserveOleImageAsImage) flag is enabled, DocIO internally skips to read the embedded Ole image of large file size (.bin), instead DocIO reuses the Ole image from Word document as normal image for the same visual appearance. This will reduce the memory usage in DocIO DOM and resolves “Out of memory exception” at some cases.
490+
491+
The following code example shows how to preserve embedded Ole image as normal image in a Word document.
492+
493+
{% tabs %}
494+
495+
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Ole-image-as-normal-image/.NET/Ole-image-as-normal-image/Program.cs" %}
496+
//Creates a new instance of WordDocument (Empty Word Document)
497+
using (WordDocument document = new WordDocument())
498+
{
499+
//Loads or opens an existing Word document from stream
500+
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
501+
// Sets flag to preserve embedded Ole image as normal image while opening document
502+
document.Settings.PreserveOleImageAsImage = true;
503+
//Loads or opens an existing Word document through Open method of WordDocument class
504+
document.Open(fileStreamPath, FormatType.Automatic);
505+
//Saves the Word document to MemoryStream.
506+
MemoryStream stream = new MemoryStream();
507+
document.Save(stream, FormatType.Docx);
508+
//Closes the Word document.
509+
document.Close();
510+
}
511+
{% endhighlight %}
512+
513+
{% highlight c# tabtitle="C# [Windows-specific]" %}
514+
//Creates an empty Word document instance
515+
WordDocument document = new WordDocument();
516+
//Sets flag to preserve embedded Ole image as normal image while opening document
517+
document.Settings.PreserveOleImageAsImage = true;
518+
//Loads or opens an existing Word document
519+
document.Open("Template.docx");
520+
//Saves and closes the Word document
521+
document.Save("Sample.docx", FormatType.Docx);
522+
document.Close();
523+
{% endhighlight %}
524+
525+
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
526+
'Creates an empty Word document instance
527+
Dim document As New WordDocument()
528+
'Sets flag to preserve embedded Ole image as normal image while opening document
529+
document.Settings.PreserveOleImageAsImage = True
530+
'Loads or opens an existing Word document
531+
document.Open("Template.docx")
532+
'Saves and closes the Word Document
533+
document.Save("Sample.docx", FormatType.Docx)
534+
document.Close()
535+
{% endhighlight %}
536+
537+
{% endtabs %}
538+
539+
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Ole-image-as-normal-image).
540+
483541
## Online Demo
484542

485543
* Explore how to insert an OLE Object into the Word document using the .NET Word Library (DocIO) in a live demo [here](https://document.syncfusion.com/demos/word/insertoleobject#/tailwind).

Document-Processing/Word/Word-Library/NET/Working-with-Macros.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,6 @@ using (FileStream fileStream = new FileStream("Template.dotm", FileMode.Open, Fi
3030
{
3131
//Saves the Word document to stream.
3232
document.Save(stream, FormatType.Word2013Docm);
33-
}
3433
}
3534
}
3635
}

0 commit comments

Comments
 (0)