OfficeIMO.Word
0.20.0
Prefix Reserved
dotnet add package OfficeIMO.Word --version 0.20.0
NuGet\Install-Package OfficeIMO.Word -Version 0.20.0
<PackageReference Include="OfficeIMO.Word" Version="0.20.0" />
paket add OfficeIMO.Word --version 0.20.0
#r "nuget: OfficeIMO.Word, 0.20.0"
// Install OfficeIMO.Word as a Cake Addin #addin nuget:?package=OfficeIMO.Word&version=0.20.0 // Install OfficeIMO.Word as a Cake Tool #tool nuget:?package=OfficeIMO.Word&version=0.20.0
This is a small project (under development) that allows to create Microsoft Word documents (.docx) using .NET. Underneath it uses OpenXML SDK but heavily simplifies it. It was created because working with OpenXML is way too hard for me, and time consuming. I originally created it for using within PowerShell module called PSWriteOffice, but thought it may be useful for others to use in the .NET community.
For changes between versions see CHANGELOG
Examples
Basic Document with few document properties and paragraph
This short example show how to create Word Document with just one paragraph with Text and few document properties.
string filePath = @"C:\Support\GitHub\PSWriteOffice\Examples\Documents\BasicDocument.docx";
using (WordDocument document = WordDocument.Create(filePath)) {
document.Title = "This is my title";
document.Creator = "Przemysław Kłys";
document.Keywords = "word, docx, test";
var paragraph = document.AddParagraph("Basic paragraph");
paragraph.ParagraphAlignment = JustificationValues.Center;
paragraph.Color = SixLabors.ImageSharp.Color.Red;
document.Save(true);
}
Basic Document with Headers/Footers (first, odd, even)
This short example shows how to add headers and footers to Word Document.
using (WordDocument document = WordDocument.Create(filePath)) {
document.Sections[0].PageOrientation = PageOrientationValues.Landscape;
document.AddParagraph("Test Section0");
document.AddHeadersAndFooters();
document.DifferentFirstPage = true;
document.DifferentOddAndEvenPages = true;
document.Sections[0].Header.First.AddParagraph().SetText("Test Section 0 - First Header");
document.Sections[0].Header.Default.AddParagraph().SetText("Test Section 0 - Header");
document.Sections[0].Header.Even.AddParagraph().SetText("Test Section 0 - Even");
document.AddPageBreak();
document.AddPageBreak();
document.AddPageBreak();
document.AddPageBreak();
var section1 = document.AddSection();
section1.PageOrientation = PageOrientationValues.Portrait;
section1.AddParagraph("Test Section1");
section1.AddHeadersAndFooters();
section1.Header.Default.AddParagraph().SetText("Test Section 1 - Header");
section1.DifferentFirstPage = true;
section1.Header.First.AddParagraph().SetText("Test Section 1 - First Header");
document.AddPageBreak();
document.AddPageBreak();
document.AddPageBreak();
document.AddPageBreak();
var section2 = document.AddSection();
section2.AddParagraph("Test Section2");
section2.PageOrientation = PageOrientationValues.Landscape;
section2.AddHeadersAndFooters();
section2.Header.Default.AddParagraph().SetText("Test Section 2 - Header");
document.AddParagraph("Test Section2 - Paragraph 1");
var section3 = document.AddSection();
section3.AddParagraph("Test Section3");
section3.AddHeadersAndFooters();
section3.Header.Default.AddParagraph().SetText("Test Section 3 - Header");
Console.WriteLine("Section 0 - Text 0: " + document.Sections[0].Paragraphs[0].Text);
Console.WriteLine("Section 1 - Text 0: " + document.Sections[1].Paragraphs[0].Text);
Console.WriteLine("Section 2 - Text 0: " + document.Sections[2].Paragraphs[0].Text);
Console.WriteLine("Section 2 - Text 1: " + document.Sections[2].Paragraphs[1].Text);
Console.WriteLine("Section 3 - Text 0: " + document.Sections[3].Paragraphs[0].Text);
Console.WriteLine("Section 0 - Text 0: " + document.Sections[0].Header.Default.Paragraphs[0].Text);
Console.WriteLine("Section 1 - Text 0: " + document.Sections[1].Header.Default.Paragraphs[0].Text);
Console.WriteLine("Section 2 - Text 0: " + document.Sections[2].Header.Default.Paragraphs[0].Text);
Console.WriteLine("Section 3 - Text 0: " + document.Sections[3].Header.Default.Paragraphs[0].Text);
document.Save(true);
}
Advanced usage of OfficeIMO
string filePath = System.IO.Path.Combine(folderPath, "AdvancedDocument.docx");
using (WordDocument document = WordDocument.Create(filePath)) {
// lets add some properties to the document
document.BuiltinDocumentProperties.Title = "Cover Page Templates";
document.BuiltinDocumentProperties.Subject = "How to use Cover Pages with TOC";
document.ApplicationProperties.Company = "Evotec Services";
// we force document to update fields on open, this will be used by TOC
document.Settings.UpdateFieldsOnOpen = true;
// lets add one of multiple added Cover Pages
document.AddCoverPage(CoverPageTemplate.IonDark);
// lets add Table of Content (1 of 2)
document.AddTableOfContent(TableOfContentStyle.Template1);
// lets add page break
document.AddPageBreak();
// lets create a list that will be binded to TOC
var wordListToc = document.AddTableOfContentList(WordListStyle.Headings111);
wordListToc.AddItem("How to add a table to document?");
document.AddParagraph("In the first paragraph I would like to show you how to add a table to the document using one of the 105 built-in styles:");
// adding a table and modifying content
var table = document.AddTable(5, 4, WordTableStyle.GridTable5DarkAccent5);
table.Rows[3].Cells[2].Paragraphs[0].Text = "Adding text to cell";
table.Rows[3].Cells[2].Paragraphs[0].Color = Color.Blue; ;
table.Rows[3].Cells[3].Paragraphs[0].Text = "Different cell";
document.AddParagraph("As you can see adding a table with some style, and adding content to it ").SetBold().SetUnderline(UnderlineValues.Dotted).AddText("is not really complicated").SetColor(Color.OrangeRed);
wordListToc.AddItem("How to add a list to document?");
var paragraph = document.AddParagraph("Adding lists is similar to ading a table. Just define a list and add list items to it. ").SetText("Remember that you can add anything between list items! ");
paragraph.SetColor(Color.Blue).SetText("For example TOC List is just another list, but defining a specific style.");
var list = document.AddList(WordListStyle.Bulleted);
list.AddItem("First element of list", 0);
list.AddItem("Second element of list", 1);
var paragraphWithHyperlink = document.AddHyperLink("Go to Evotec Blogs", new Uri("https://evotec.xyz"), true, "URL with tooltip");
// you can also change the hyperlink text, uri later on using properties
paragraphWithHyperlink.Hyperlink.Uri = new Uri("https://evotec.xyz/hub");
paragraphWithHyperlink.ParagraphAlignment = JustificationValues.Center;
list.AddItem("3rd element of list, but added after hyperlink", 0);
list.AddItem("4th element with hyperlink ").AddHyperLink("included.", new Uri("https://evotec.xyz/hub"), addStyle: true);
document.AddParagraph();
var listNumbered = document.AddList(WordListStyle.Heading1ai);
listNumbered.AddItem("Different list number 1");
listNumbered.AddItem("Different list number 2", 1);
listNumbered.AddItem("Different list number 3", 1);
listNumbered.AddItem("Different list number 4", 1);
var section = document.AddSection();
section.PageOrientation = PageOrientationValues.Landscape;
section.PageSettings.PageSize = WordPageSize.A4;
wordListToc.AddItem("Adding headers / footers");
// lets add headers and footers
document.AddHeadersAndFooters();
// adding text to default header
document.Header.Default.AddParagraph("Text added to header - Default");
var section1 = document.AddSection();
section1.PageOrientation = PageOrientationValues.Portrait;
section1.PageSettings.PageSize = WordPageSize.A5;
wordListToc.AddItem("Adding custom properties to document");
document.CustomDocumentProperties.Add("TestProperty", new WordCustomProperty { Value = DateTime.Today });
document.CustomDocumentProperties.Add("MyName", new WordCustomProperty("Some text"));
document.CustomDocumentProperties.Add("IsTodayGreatDay", new WordCustomProperty(true));
document.Save(openWord);
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 is compatible. net48 is compatible. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.7.2
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
.NETFramework 4.8
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
.NETStandard 2.0
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
.NETStandard 2.1
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
net6.0
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
net7.0
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
-
net8.0
- DocumentFormat.OpenXml (>= 3.1.0 && < 4.0.0)
- SixLabors.ImageSharp (>= 2.1.9 && < 3.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.20.0 | 159 | 9/27/2024 |
0.19.0 | 368 | 9/24/2024 |
0.18.0 | 149 | 9/22/2024 |
0.17.0 | 3,910 | 6/21/2024 |
0.16.0 | 1,330 | 6/17/2024 |
0.15.0 | 5,320 | 5/13/2024 |
0.14.0 | 5,751 | 4/4/2024 |
0.13.0 | 6,399 | 2/2/2024 |
0.12.0 | 3,298 | 12/31/2023 |
0.11.0 | 1,978 | 11/27/2023 |
0.10.0 | 6,885 | 10/24/2023 |
0.9.0 | 7,290 | 8/15/2023 |
0.8.0 | 4,222 | 7/30/2023 |
0.7.0 | 3,417 | 7/16/2023 |
0.6.0 | 709 | 7/3/2023 |
0.5.0 | 1,133 | 6/5/2023 |
0.4.9 | 10,484 | 3/19/2023 |
0.4.8 | 9,154 | 2/8/2023 |
0.4.7 | 3,169 | 1/14/2023 |
0.4.6 | 2,787 | 1/11/2023 |
0.4.5 | 769 | 1/9/2023 |
0.4.4 | 748 | 1/9/2023 |
0.4.3 | 750 | 1/9/2023 |
0.4.2 | 3,795 | 11/25/2022 |
0.4.1 | 802 | 11/20/2022 |
0.4.0 | 3,858 | 11/13/2022 |
0.3.1 | 1,968 | 10/18/2022 |
0.3.0 | 1,189 | 10/11/2022 |
0.2.1 | 1,119 | 7/31/2022 |
0.2.0 | 789 | 7/31/2022 |
0.1.7 | 931 | 6/12/2022 |
0.1.6 | 888 | 6/11/2022 |
0.1.5 | 827 | 6/4/2022 |
0.1.4 | 1,054 | 4/3/2022 |
0.1.3 | 884 | 4/3/2022 |