Pull to refresh

FluentOpenXml — Foxby

Reading time 5 min
Views 3.5K
Foxby — это библиотека для работы с Word документами в формате OpenXml. Предназначена для генерации документов по шаблону и внесения изменений в существующие документы. С помощью неё вы сможете отказаться от работы с COM+ или редактирования OpenXML-дерева через OpenXML SDK и перейти к механизму построения структуры документа из метаэлементов в декларативном виде.

В классе решаемых задач: создание параграфов, создание и заполнение таблиц, списков, работа с изображениями, форматирование и т.п. Фактически библиотека является оберткой над OpenXML SDK с API в виде Fluent-интерфейса.

Преимущества использования



Мы сами используем эту библиотеку уже в двух проектах. Первая версия была написана Eskat0n и зарождалась, как часть подсистемы проекта по работе с Word-документами, но в дальнейшем была вынесена в самостоятельный проект.

Можно выделить следующие преимущества:
  1. На сервере, где работает ваше приложение, не требуется установка Microsoft Office
  2. Нет проблемы с зависшими процессами Word
  3. Работает гораздо быстрее, чем COM+
  4. Создание и изменение документов не требует записи на жесткий диск, всё происходит в оперативной памяти
  5. Удобный Fluent API для работы с объектами Word
  6. Возможность построения своего метаязыка разметки документа


Установка



Последнюю версию можно установить через NuGet:



Исходный код и лицензия



Исходный код написан на .NET 4.0/C# и выложен на Google Code:fluent-openxml компанией IndyCode под лицензией LGPL.

Примеры использования



Ниже приведены примеры, с помощью которых можно будет начать работать с библиотекой.

Пример №1 — Hello Word!



private static void Main()
{
  using (var docxDocument = new DocxDocument(SimpleTemplate.EmptyWordFile))
  {
    var builder = new DocxDocumentBuilder(docxDocument);

    builder
      .Tag(SimpleTemplate.ContentTagName,
         x => x.Center.Paragraph(z => z.Bold.Text("Hello Word!")));

    File.WriteAllBytes(string.Format(@"D:\Word.docx"), docxDocument.ToArray());
  }
}

* This source code was highlighted with Source Code Highlighter.




SimpleTemplate.EmptyWordFile это шаблон, который встроен в саму библиотеку. В шаблоне ничего нет, кроме тэгов для верхнего колонтитула, контента и нижнего колонтитула. Этот шаблон отлично подойдет для тестовых целей и генерации простых документов.

Вместо File.WriteAllBytes, который записывает файл на диск, массив байт можно передавать как FileResult, чтобы пользователь сразу получал сгенерированный документ.

Иерархия вложения должна помочь понять идеологию работы с библиотекой:


Пример №2 Создадим договор



Очень часто требуется создать договор или счет-фактуру. Этот пример показывает типичный сценарий создания документа. Для простоты переменные берутся не из базы данных, а определяются переменными.

private static void Main()
{
  string customerName = "Иванов И.В.";
  string orderNumber = "4";
  string itemName1 = "Табуретка";
  string itemSumm1 = "5 000";
  string itemName2 = "Кран погрузочный";
  string itemSumm2 = "6 342";
  string summ = "11 342";

  using (var docxDocument = new DocxDocument(SimpleTemplate.EmptyWordFile))
  {
    var builder = new DocxDocumentBuilder(docxDocument);

    builder
      .Tag(SimpleTemplate.ContentTagName,
         x => x
          .Center.Paragraph(z => z.Bold.Text(string.Format("Договор №{0}", orderNumber)))
          .Right.Paragraph(string.Format("от {0} г.", DateTime.Now.ToString("dd MMMM yyyy")))
          .Left.Paragraph(string.Format("Я, {0}, покупаю:", customerName))
          .Table(t => t.Column("Товар", 70).Column("Цена, руб.", 30),
              r => r.Row(itemName1, itemSumm1)
                 .Row(itemName2, itemSumm2)
                 .Row(w => w.Right.Bold.Text("Итого:"), w=>w.Center.Bold.Underlined.Text(summ))
          ));

    File.WriteAllBytes(string.Format(@"D:\Word.docx"), docxDocument.ToArray());
  }
}


* This source code was highlighted with Source Code Highlighter.




Пример №3 — Изменяем созданный документ


Сценарий:
  1. Создаем документ за подписью Иванова К.И.
  2. Отправляем документ на согласование
  3. Электронный документ возвращают и говорят, что подписывать должен Петров А.И.
  4. Меняем подписывающего в документе


private static void Main()
{
  using (var docxDocument = new DocxDocument(SimpleTemplate.EmptyWordFile))
  {
    var builder = new DocxDocumentBuilder(docxDocument);

    builder
      .Tag(SimpleTemplate.ContentTagName,
         x => x.Left.Paragraph("Договор на оказание услуг...")
           .Right.Paragraph(z => z.Placeholder("SIGNER_NAME", "Иванов К.И.")));

    File.WriteAllBytes(string.Format(@"D:\Word.docx"), docxDocument.ToArray());
  }

  using (var docxDocument = new DocxDocument(File.ReadAllBytes(@"D:\Word.docx")))
  {
    var builder = new DocxDocumentBuilder(docxDocument);

    builder
      .Placeholder("SIGNER_NAME", x => x.Text("Петров А.И."));

    File.WriteAllBytes(string.Format(@"D:\Word.docx"), docxDocument.ToArray());
  }
}


* This source code was highlighted with Source Code Highlighter.




Пример №4 — Создаем документ «с нуля»



private static void Main()
{
  using (var docxDocument = new DocxDocument())
  {
    docxDocument.AddOpenCloseTag("CONTENT");

    var builder = new DocxDocumentBuilder(docxDocument);

    builder
      .Tag("CONTENT", x => x.Left.Paragraph("Договор на оказание услуг..."));

    File.WriteAllBytes(string.Format(@"D:\Word.docx"), docxDocument.ToArray());
  }
}


* This source code was highlighted with Source Code Highlighter.




Пример №5 — Модульные тесты


К библиотеке написано довольно много модульных тестов, с помощью которых вы сможете еще лучше понять сценарии работы. Скачать исходный код с тестами можно с Google Code:fluent-openxml.

Плюшки



Александр Зайцев поразвлекался и сделал довольно интересную реализацию для форматирования текста:

builder.Tag("CONTENT", x => x.Paragraph("Жирный ".Bold() + "Курсив ".Italic() + "Подчеркнутый ".Underlined() + "Нормальный"));

* This source code was highlighted with Source Code Highlighter.


Такой способ можно использовать для текста, как альтернативу для свойства Bold.

Обратная связь



Эта библиотека может быть лучше и работать с большим количеством различных специфических ситуаций, если вы дадите нам обратную связь.




Ссылки

Видео и слайды с конференции DotNetConf: Анонс OpenSource библиотеки для создания и изменения документов в формате OpenXml через Fluent-интерфейс
Tags:
Hubs:
+15
Comments 25
Comments Comments 25

Articles