Брайн Джонс: Расширяемый Офис https://docs.microsoft.com/archive/blogs/brian_jones_ru/feed.xml Это зеркало оригинального блога на русском языке. Вы можете узнать больше об оригинальном блоге по адресу https://blogs.msdn.com/brian_jones/ Wed, 17 Apr 2019 03:18:57 GMT en-US hourly 1 Изменения в CTP-версии пакета SDK Open XML версии 2 (апрель 2009 г.) https://docs.microsoft.com/archive/blogs/brian_jones_ru/ctp-sdk-open-xml-10 Thu, 02 Jul 2009 17:41:15 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/ctp-sdk-open-xml-10/ Одно из важных изменений, внесенных в CTP-версию пакета SDK Open XML версии 2 (апрель 2009 г.), заключается в улучшении компонента DOM-модели низкого уровня с целью включения функций, связанных с пакетом обновления 2 (SP2) системы Office 2007. Эта модернизация изменила способ интерпретации некоторых элементов как свойств 1-го класса родительского класса/элемента по отношению к дочернему. Например, SdtProperties теперь не является свойством классов SdtXXX, а интерпретируется как дочерний элемент. Просматривая различные каналы связи с пользователями, сообщения на форуме по Open XML SDK, www.openxmldeveloper.org, а также сайт SDK Connect, я заметил, что это изменение противоречит некоторым из моих предыдущих записей и примеров кода. В сегодняшней записи я продемонстрирую применение обходного решения этой проблемы и приведу примеры того, как исправить неработающий в настоящее время код и сделать его совместимым с апрельской CTP-версией пакета SDK.

SdtBlock не содержит определение для свойств SdtProperties

Во многих моих записях о пакете SDK, касающихся программы Word, элементы управления содержимым рассматриваются как семантическая структура. В своих записях я демонстрирую использование элементов управления содержимым для быстрого поиска содержимого или добавления его в конкретные области. Во многих сообщениях используется следующая конструкция фрагмента кода:

SdtBlock sdt = mainPart.Document.Descendants<SdtBlock>()
.Where(s => s.SdtProperties.GetFirstChild<Alias>().Val.Value
.Equals(sdtName)).First();

Если попытаться скомпилировать приведенный выше фрагмент кода в последней CTP-версии пакета SDK, возникнет следующая ошибка компилятора:

'DocumentFormat.OpenXml.Wordprocessing.SdtBlock' does not contain a definition for 'SdtProperties' and no extension method 'SdtProperties' accepting a first argument of type 'DocumentFormat.OpenXml.Wordprocessing.SdtBlock' could be found (are you missing a using directive or an assembly reference?)

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

SdtBlock sdt = mainPart.Document.Descendants<SdtBlock>()

.Where(s =>

s.GetFirstChild<SdtProperties>().GetFirstChild<Alias>().Val.Value

.Equals(sdtName)).First();

SdtBlock не содержит определение для SdtContentBlock

Аналогично случаю с SdtProperties SdtContentBlock перемещен в дочерние элементы и не является больше свойством. Необходимо изменить следующий фрагмент кода:

Paragraph p = sdt.SdtContentBlock.GetFirstChild<Paragraph>();

чтобы он выглядел так:

Paragraph p = sdt.GetFirstChild<SdtContentBlock>().GetFirstChild<Paragraph>();

Ссылки на примеры исправленных версий кода или решений

Ниже приведены ссылки на исправленные версии прежних решений, функциональность которых была нарушена вследствие внесения изменений в апрельской CTP-версии 2009 года.

Отзывы

В настоящее время мы ищем пути улучшения поведения пакета SDK и возвращения в него некоторых их утраченных функций, в частности связанных с тем, что некоторые элементы не рассматриваются, как свойства 1го класса. Следите за обновлениями.

Хочу воспользоваться случаем и поблагодарить вас за отзывы. Оставайтесь на связи.

Спасибо.

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/05/19/breaking-changes-in-the-open-xml-sdk-v2-april-2009-ctp.aspx.]]> Новые средства для решений Open XML https://docs.microsoft.com/archive/blogs/brian_jones_ru/open-xml Thu, 02 Jul 2009 17:41:09 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/open-xml/ Пока я работаю над завершением еще одного решения блога, на этот раз посвященного импорту таблиц из Word в Excel, мне бы хотелось поделиться сведениями о двух полезных средствах, которыми можно воспользоваться при построении решений на основе Open XML. Первое средство, о котором я собираюсь рассказать, это следующий выпуск PowerTools для Open XML. PowerTools для Open XML представляет собой проект разработки открытого кода на веб-сайте CodePlex, который полностью основан на версии 1 пакета Open XML SDK. Это средство поддерживает архитектуру конвейеров PowerShell, предоставляя более 30 командлетов. Рассматривайте командлет как "черный ящик", в который поступает что-то одно, а наружу выходит что-то другое. В случае с PowerTools для Open XML командлеты различными способами создают и изменяют документы Open XML. Например, существуют командлеты для удаления примечаний, принятия отслеживаемых изменений, объединения документов или разделов и даже для создания диаграмм. Самым интересным является то, что ИТ-специалисты и разработчики могут выполнять пакетные сценарии непосредственно в PowerShell. Кстати, данное средство выпущено в качестве открытого кода в соответствии с общедоступной лицензией Майкрософт (Ms-PL), и это означает, что любой может свободно использовать код при создании собственных решений.

Эрик Уайт (Eric White) опубликовал очень хорошую запись в блоге, где описал некоторые подробности версии 1.1 пакета PowerTools для Open XML. В записи приводятся отличные примеры, демонстрирующие объединение разделов документов. В моей предыдущей записи я показал простой способ объединения документов Word с использованием altChunks. Версия 1.1 пакета PowerTools для Open XML выполняет объединение более сложным образом. Посмотрите и сообщите нам свое мнение.

Следующее средство, о котором мне бы хотелось поговорить, касается создания решений для документов Office в рамках машинного кода, такого как C++. Пакет Open XML SDK — это отличное средство, но оно привязано к технологиям .NET, т.к. зависит от пространства имен System.IO.Packaging. Как создать решение с использованием машинного кода? Раньше в подобных случаях вам бы пришлось либо создавать собственный уровень перехода от машинного кода к управляемому, или каким-то образом переключать контекст. Хорошая новость: Майкрософт недавно выпустила версию Win32 пространства имен System.IO.Packaging под названием Win32 OPC. Вопросы, касающиеся этой технологии, можно размещать на форуме или в блоге Win32 OPC.

Спасибо.

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/03/26/more-open-xml-solution-tools.aspx.]]> Импорт таблицы из WordprocessingML в SpreadsheetML https://docs.microsoft.com/archive/blogs/brian_jones_ru/wordprocessingml-spreadsheetml Thu, 02 Jul 2009 17:37:24 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/wordprocessingml-spreadsheetml/ В предыдущей записи я показал, как импортировать диаграммы из электронных таблиц в текстовый документ. Сегодня, как я и обещал в прошлой записи, я продемонстрирую импорт таблицы из текстового документа в электронную таблицу.

Решение

Чтобы импортировать таблицу из текстового документа в электронную таблицу, необходимо выполнить следующие действия:

  1. Создать в Word шаблон с элементом управления содержимым, который будет использоваться для разметки области импортируемой таблицы.
  2. Открыть документ Word с помощью пакета Open XML SDK.
  3. Открыть целевую книгу Excel, которая будет содержать импортированную таблицу, с помощью пакета Open XML SDK.
  4. Найти элемент управления содержимым, включающий таблицу Word, и получить доступ к табличному объекту.
  5. Преобразовать таблицу Word в электронную таблицу Excel. Под преобразованием понимается создание вручную таблицы Excel на основе данных таблицы Word.
  6. Добавить раздел определения таблицы в рабочую книгу Excel.
  7. Присвоить определению добавленной таблицы уникальное имя и идентификатор.
  8. Указать диапазон таблицы на основе вставляемых данных.
  9. Добавить сведения для заголовка столбцов в раздел определения таблицы.
  10. Добавить ссылку на стиль в определение таблицы.
  11. Сохранить изменения в рабочей книге Excel.

В моей демонстрации будет использоваться пакет SDK версии 2.

Чтобы более наглядно представить изложенный здесь материал, начнем работать со следующим документом Word и таблицей (следует отметить, что таблица содержится в элементе управления содержимым):

Кроме того, мы будем использовать пустую книгу Excel, содержащую лишь определение стиля для таблиц.

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

Как описано в предыдущем разделе, для выполнения шагов 2 и 3 требуется открыть файлы Word и Excel. Для этого используется следующий фрагмент кода:

//Open Word document
using (WordprocessingDocument myDoc = WordprocessingDocument.Open("tables.docx", true))
{
MainDocumentPart mainPart = myDoc.MainDocumentPart;
//Open spreadhseet
using (SpreadsheetDocument mySpreadsheet = SpreadsheetDocument.Open("output.xlsx", true))
{
WorkbookPart workbookPart = mySpreadsheet.WorkbookPart;
//Import a specific table from the document into a specific sheet within the spreadsheet
ImportWordTable(mainPart, "WorldPopulationTable", workbookPart, "Sheet1");
}
}

Я создал универсальный метод ImportWordTable, выполняющий все остальные шаги представленного выше раздела "Решение". Следующий шаг — получение доступа к табличному объекту Word, находящемуся в элементе управления содержимым. Это можно осуществить с помощью следующего кода:

//Find the content control that contains the specific table
SdtBlock sdt = mainPart.Document.Descendants<SdtBlock>()
.Where(s => s.SdtProperties.GetFirstChild<Alias>().Val.Value
.Equals(sdtName)).First();
Table tbl = sdt.SdtContentBlock.GetFirstChild<Table>();

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

static Spreadsheet.SheetData ConvertWordTableToExcel(Table tbl)
{
//sheetdata contains data for table
Spreadsheet.SheetData sheetdata = new Spreadsheet.SheetData();
//For every row in my Word table we need to create a row in Excel
foreach (TableRow row in tbl.Descendants<TableRow>())
{
numRows++;
Spreadsheet.Row sheetRow = new Spreadsheet.Row();
//For every Word cell create an Excel cell
foreach (TableCell cell in row.Descendants<TableCell>())
{
Spreadsheet.Cell sheetCell = new Spreadsheet.Cell();
string textValue = cell.InnerText;
double numValue;
//Check to see if value is a number rather than a string
//First row should be strings because I am going to create a table
if ((numRows != 1) && (Double.TryParse(textValue, System.Globalization.NumberStyles.Any, null, out numValue)))
{
Spreadsheet.CellValue v = new Spreadsheet.CellValue();
textValue = numValue.ToString();
v.Text = textValue;
sheetCell.Append(v);
}
else //value is a string
{
sheetCell.DataType = Spreadsheet.CellValues.InlineString;
Spreadsheet.InlineString inlineString = new Spreadsheet.InlineString();
Spreadsheet.Text t = new Spreadsheet.Text();
t.Text = textValue;
inlineString.Append(t);
sheetCell.Append(inlineString);
}
//Need to keep track of column headers for the table
//definitions part
if (numRows == 1)
colHeaders.Add(textValue);
sheetRow.Append(sheetCell);
}
    
sheetdata.Append(sheetRow);
}
return sheetdata;
}

Представленный выше фрагмент кода создает для каждой строки и ячейки таблицы Word строку и ячейку в электронной таблице Excel. Ячейка электронной таблицы немного отличается от ячейки таблицы Word, поскольку в ячейке электронной таблицы содержится определение типа содержимого. В приведенном примере у нас два типа ячеек.

  1. Текст.
  2. Число.

Поскольку решение предполагает создание таблицы Excel, необходимо помнить еще о некоторых вещах. Во-первых, следует убедиться, что первая строка таблицы содержит только текстовые ячейки, поскольку она будет определена как строка заголовка. Во-вторых, необходимо отслеживать текст в строке заголовка, поскольку он будет повторно использован в разделе определений таблицы.

В конце этого шага мы создали допустимую электронную таблицу Excel, содержащую все данные из таблицы Word.

На этом работа могла бы быть закончена, но мы можем улучшить вывод, отформатировав данные в виде таблицы.

Вернувшись к шагу 6 в разделе "Решение", необходимо добавить ссылку на раздел определений таблицы на листе, содержащем данные. Ниже представлен фрагмент кода, создающий новый раздел определения таблицы и добавляющий ссылку на этот раздел с листа, содержащего табличные данные.

//Add the table definitions part to make the imported table look like a table
TableDefinitionPart tableDefPart = worksheetPart.AddNewPart<TableDefinitionPart>(relId);
//Reference the added table part
Spreadsheet.TableParts tableParts = new Spreadsheet.TableParts();
Spreadsheet.TablePart tablePart = new Spreadsheet.TablePart();
tablePart.Id = relId;
tableParts.Append(tablePart);
worksheetPart.Worksheet.Append(tableParts);

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

int id = 1;
tableDefPart.Table = new Spreadsheet.Table();
tableDefPart.Table.Id = 1;
tableDefPart.Table.Name = "Table1";
tableDefPart.Table.DisplayName = "Table1";
char endCol = 'A';
//Note that this approach is good for columns up to Z
//Excel can contain more columns, but 26 columns should
//be good enough for this demo
for (int i = 1; i < numCols; i++)
endCol++;
//Specify the range of the table
string reference = "A1:" + endCol + numRows;
tableDefPart.Table.Reference = reference;

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

//Make sure the table has the ability to filter
Spreadsheet.AutoFilter autoFilter = new Spreadsheet.AutoFilter();
autoFilter.Reference = reference;
Spreadsheet.TableColumns tableColumns = new Spreadsheet.TableColumns();
tableColumns.Count = numCols;

Теперь добавим сведения для заголовка таблицы.

//Add the column headers to the table definition part
foreach (string s in colHeaders)
{
Spreadsheet.TableColumn tableColumn = new Spreadsheet.TableColumn();
tableColumn.Id = (uint)id;
tableColumn.Name = s;
id++;
tableColumns.Append(tableColumn);
}

Почти готово! Теперь поработаем над внешним видом таблицы, применив стиль. После применения стиля можно объединить все необходимые элементы и сохранить изменения. Это можно выполнить, используя следующий код:

//Apply a nice table style (contained within my template)
Spreadsheet.TableStyleInfo tableStyleInfo = new Spreadsheet.TableStyleInfo();
tableStyleInfo.Name = "TableStyleMedium9";
tableStyleInfo.ShowRowStripes = true;
tableDefPart.Table.Append(autoFilter, tableColumns, tableStyleInfo);
tableDefPart.Table.Save();

Заключение

Собрав вместе все показанные фрагменты и запустив итоговый код, мы получим рабочую книгу Excel, содержащую импортированную из документа Word таблицу.

Вот снимок экрана с полученной книгой (обратите внимание на возможность фильтрации):

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/04/01/importing-a-table-from-wordprocessingml-to-spreadsheetml.aspx.]]> Переходы по дереву DOM-модели Open XML https://docs.microsoft.com/archive/blogs/brian_jones_ru/dom-open-xml Thu, 02 Jul 2009 17:37:23 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/dom-open-xml/ В последних записях я уделял внимание демонстрации решений для реальных, повседневных сценариев. Сегодня я сменю темп и продолжу обсуждение Али, посвященное основным сведениям о пакете Open XML SDK. В этой записи мы рассмотрим основные методы перехода по дереву DOM-модели Open XML с помощью пакета Open XML SDK.

И снова, это всего лишь XML...

Мы разработали DOM-модель низкого уровня для Open XML в качестве XML-оболочки схем Open XML. Иными словами, этот компонент пакета SDK позволяет работать непосредственно со строго типизированными объектами и классами, представляющими основные узлы XML. По сути, даже используя SDK, вы продолжаете работать только с XML.

Существует несколько традиционных технологий, позволяющих выполнять переход на более низкий уровень дерева XML. При разработке Open XML SDK мы хотели включить в пакет функции DOM и LINQ, чтобы предоставить пользователям богатый набор средств. Компонент DOM-модели низкого уровня — это попытка объединить концепции API-интерфейса DOM-модели .NET и LINQ в XML. Рассмотрим некоторые из этих концепций.

Переход на более низкий уровень дерева XML

Одной из наиболее распространенных задач при чтении XML-файлов является переход на более низкий уровень конкретного узла XML, например корневого. Обычно переход вниз требуется при поиске. Допустим, вам необходимо изменить содержимое всех строк таблицы в документе. Одним их способов выполнения такого сценария является переход на более низкий уровень, начиная с корневого элемента документа с нахождением таблицы и элементов строк таблицы до тех пор, пока не будет достигнут конец документа. Open XML SDK упрощает решение этой задачи.

Как уже упоминалось в записи Али, все элементы Open XML основываются на абстрактном классе OpenXMLElement. Класс OpenXMLElement предоставляет следующие методы и свойства для перехода вниз в пределах DOM-модели:

  1. OpenXMLElement FirstChild { get; }
  2. OpenXMLElement LastChild { get; }
  3. IEnumerable<OpenXmlElement> Elements ()
  4. OpenXmlElementList ChildElements { get; }.
  5. IEnumerable<OpenXmlElement> GetEnumerator ()
  6. IEnumerable<OpenXmlElement> Descendants ()

Между перечисленными подходами существуют некоторые ключевые различия. Для более наглядного представления этих различий представьте, что вам необходимо выполнить чтение элементов в объекте Table, который содержит свойства таблицы, сведения о сетке таблицы и содержимое строк:

<w:tbl>
<w:tblPr>
...
</w:tblPr>
<w:tblGrid>
...
</w:tblGrid>
<w:tr>
...
</w:tr>
...
<w:tr>
...
</w:tr>
</w:tbl>

Методы FirstChild() и LastChild() довольно прямолинейны. Они возвращают первый и последний дочерние элементы соответственно.

Метод Elements() позволяет выполнять чтение всех дочерних элементов объекта Table, используя следующий фрагмент кода:

foreach (OpenXmlElement el in tbl.Elements())
{
//DO SOMETHING
}

Свойство ChildElements немного отличается от остальных. При его непосредственном вызове, подобно tbl.ChildElements, оно возвращает список элементов Open XML, являющихся дочерними элементами таблицы. В этом отношении оно эквивалентно свойству tbl.Elements(). Отличие свойства ChildElements от Elements() заключается в возможности указания индекса. Например, если требуется четвертый дочерний элемент объекта Table, вы вызываете свойство tbl.ChildElements[3].

Подобно двум другим подходам, метод GetEnumerator() обеспечивает поддержку итерации по всем дочерним элементам.

Метод Descendants(), наоборот, позволяет выполнять итерацию по всем дочерним элементам и потомкам конкретного узла. Используя объект Table в качестве примера и вызвав метод Descendants(), можно не только просмотреть строки таблицы, но и ячейки внутри строк.

Вместо выполнения итерации по всем дочерним элементам более распространенный сценарий выполняет поиск дочерних элементов или потомков конкретного типа класса. Допустим, необходимо найти элементы строки таблицы под объектом Table. Вместо выполнения итерации по всем дочерним элементам с проверкой, является ли каждый из них строкой таблицы, можно просто воспользоваться следующими методами:

  1. IEnumerable<T> Elements<T> ()where T : OpenXmlElement
  2. IEnumerable<T> Descendants<T> ()where T : OpenXmlElement
  3. T GetFirstChild<T> ()where T : OpenXmlElement

Первые два метода возвращают только элементы типа T или производные от T. Для поиска в приведенном выше примере всех строк таблицы необходимо использовать следующий фрагмент кода:

foreach (TableRow tr in tbl.Elements<TableRow>())
{
//DO SOMETHING
}

Последний метод позволяет получить первый дочерний элемент, принадлежащий заданному типу. В данном случае для получения первой строки я бы использовал tbl.GetFirstChild<TableRow>().

Переход на более высокий уровень дерева XML

Подобно переходу на более низкий уровень дерева XML можно переходить и на более высокий. Эта функция обеспечивает гибкость при переходе по дереву DOM-модели. Допустим, вы выполняете поиск конкретного текста и вам необходимо получить дополнительные сведения о его контексте, например содержится ли текст в таблице. Для выполнения этого сценария необходимо выполнить переход вверх по дереву. Пакет Open XML SDK предоставляет следующие методы и свойства для перехода на более высокий уровень в DOM-модели:

  1. OpenXmlElement Parent
  2. IEnumerable<OpenXmlElement> Ancestors ()
  3. IEnumerable< T > Ancestors<T> () where T : OpenXmlElement

Свойство Parent возвращает непосредственный родительский элемент конкретного узла. При вызове свойства Parent для объекта строки таблицы возвращается объект Table.

Методы Ancestors() действуют подобно методам Descendants(), кроме того, что выполняют переход вверх, а не вниз.

Переход по горизонтали в пределах дерева XML

Что делать, если необходимо выполнить переход по дереву XML по горизонтали с просмотром одноуровневых элементов? Open XML SDK может справиться и с этим. В пакете Open XML SDK предусмотрены следующие методы для выполнения таких сценариев:

  1. OpenXmlElement PreviousSibling ()
  2. T PreviousSibling<T> () where T : OpenXmlElement
  3. OpenXmlElement NextSibling ()
  4. T NextSibling<T> () where T : OpenXmlElement
  5. IEnumerable<OpenXmlElement> ElementsBefore ()
  6. IEnumerable<OpenXmlElement> ElementsAfter ()

Первые четыре метода возвращают ближайшие элементы того же уровня, расположенные до или после текущего элемента, а остальные методы перечисляют все одноуровневые элементы, расположенные до или после элемента под тем же родительским элементом.

Заключение

Надеюсь, в этой публикации мне удалось продемонстрировать некоторые распространенные способы перехода по дереву DOM-модели Open XML. Благодаря этим функциям вы можете выполнять поиск необходимых элементов, используя всего несколько строк кода.

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/01/28/traversing-in-the-open-xml-dom.aspx.]]> Копирование листа в пределах книги https://docs.microsoft.com/archive/blogs/brian_jones_ru/63 Thu, 02 Jul 2009 17:37:21 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/63/ В прошлой записи о повторно используемых методах работы с WordprocessingML я обещал рассказать о том, как выполняется копирование листа в пределах книги. Следует заметить, что в этой записи речь пойдет о копировании листа в пределах одного пакета. Возможно, в будущем я напишу и о том, как импортировать и экспортировать листы между книгами.

Решение

Чтобы скопировать лист в пределах книги, необходимо выполнить следующие действия:

  1. Открыть документ электронной таблицы с помощью пакета Open XML SDK.
  2. Получить доступ к главному разделу книги, из которого можно получить доступ к ряду взаимосвязанных разделов, таких как отдельные листы.
  3. Получить доступ к листу, который необходимо скопировать.
  4. Создать клон найденного листа и всех связанных с ним разделов и добавить этот клон и все связанные с ним разделы в книгу.
  5. Выполнить очистку для обеспечения правильной работы таблиц, представлений и пр.
  6. Добавить ссылку на созданный лист в список листов главного раздела книги.
  7. Сохранить изменения в книге.

В моей демонстрации будет использоваться пакет SDK версии 2.

Чтобы более наглядно представить изложенный здесь материал, начнем работать с довольно сложной рабочей книгой, содержащей данные, условное форматирование, фигуру, изображение, таблицу, рисунок SmartArt и диаграмму. Книга включает три листа и имеет следующий вид:

Снимок экрана с примером книги Excel

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Сравнение методов AddPart<T>() и AddNewPart<T>()

Перед подробным рассмотрением перечисленных выше шагов я хочу рассказать о разнице между двумя методами, представленными в пакете SDK для добавления разделов в пакет Open XML. Метод AddNewPart выполняет следующие действия:

  1. Создает пустой раздел типа T и добавляет его в пакет.
  2. После создания раздела добавляет ссылку из ссылающегося раздела на новый раздел.

Следующим шагом после добавления нового раздела с помощью этого метода обычно является вызов метода FeedData() для направления данных в этот раздел.

Метод AddPart выполняет следующие действия:

  1. Если добавленный раздел еще не включен в пакет, метод добавит этот раздел и все связанные с ним разделы в пакет. Таким образом, если вы добавляете раздел А, а раздел А ссылается на раздел Б, который в свою очередь ссылается на раздел В, то при вызове этого метода, произойдет добавление разделов А, Б и В. Кроме этого, метод обеспечивает сохранность отношений добавляемых разделов. Эта функция чем-то напоминает импорт многоуровневого клона.
  2. Если добавляемый раздел уже присутствует в пакете, метод добавит ссылку из ссылающегося раздела на раздел, уже присутствующий в пакете. Например, разделы А и Б присутствуют в пакете, но раздел А не ссылается на раздел Б. При вызове данного метода добавляется ссылка из раздела А на раздел Б, если это поддерживается форматом Open XML.

Как видно, метод AddPart обладает более широкими возможностями, чем простой метод AddNewPart. Вы поймете его преимущества, когда я покажу, как выполняется создание клона раздела в пределах пакета.

Код

Как описано выше в разделе "Решение", для выполнения первых трех шагов требуется открыть книгу и получить доступ к листу, который необходимо скопировать. Для этого используются следующие фрагменты кода:

static void CopySheet(string filename, string sheetName, string clonedSheetName)
{
//Open workbook
using (SpreadsheetDocument mySpreadsheet = SpreadsheetDocument.Open(filename, true))
{
WorkbookPart workbookPart = mySpreadsheet.WorkbookPart;
//Get the source sheet to be copied
WorksheetPart sourceSheetPart = GetWorkSheetPart(workbookPart, sheetName);
...
}
}

Ниже приведен фрагмент кода, необходимый для получения доступа к разделу листа на основе имени листа.

static WorksheetPart GetWorkSheetPart(WorkbookPart workbookPart, string sheetName)
{
//Get the relationship id of the sheetname
string relId = workbookPart.Workbook.Descendants<Sheet>()
.Where(s => s.Name.Value.Equals(sheetName))
.First()
.Id;
return (WorksheetPart)workbookPart.GetPartById(relId);
}

Теперь, когда мы получили доступ к разделу листа, который необходимо скопировать, надо выполнить задачу создания клона. Именно здесь я и воспользуюсь преимуществом метода AddPart. Возможно, в будущей сборке пакета SDK будет включен метод клонирования для разделов. Как уже было сказано выше, метод AddPart отлично подходит для добавления раздела и всех разделов, на которые он ссылается. К сожалению, эта функция работает только при добавлении разделов, которые еще не присутствуют в пакете. Для обхода этого ограничения мы можем просто вызвать метод AddPart для временной книги, а затем снова вызвать метод AddPart в главной книге. Эта задача выполняется с помощью следующего кода:

static void CopySheet(string filename, string sheetName, string clonedSheetName)
{
...
//Take advantage of AddPart for deep cloning
SpreadsheetDocument tempSheet = SpreadsheetDocument.Create(new MemoryStream(), mySpreadsheet.DocumentType);
WorkbookPart tempWorkbookPart = tempSheet.AddWorkbookPart();
WorksheetPart tempWorksheetPart = tempWorkbookPart.AddPart<WorksheetPart>(sourceSheetPart);
//Add cloned sheet and all associated parts to workbook
WorksheetPart clonedSheet = workbookPart.AddPart<WorksheetPart>(tempWorksheetPart);
...
}

К этому моменту мы успешно клонировали лист и добавили его и связанные с ним разделы в книгу. Почти все готово...

Теперь необходимо выполнить некоторые задачи по очистке. Например, SpreadsheetML требует, чтобы у каждой таблицы были уникальное имя и идентификатор. Кроме этого, действительно, должен быть только один лист, установленный как главное представление. В следующем коде показано, как выполнить очистку:

static void CopySheet(string filename, string sheetName, string clonedSheetName)
{
...
//Table definition parts are somewhat special and need unique ids...so let's make an id based on count
int numTableDefParts = sourceSheetPart.GetPartsCountOfType<TableDefinitionPart>();
tableId = numTableDefParts;
//Clean up table definition parts (tables need unique ids)
if (numTableDefParts != 0)
FixupTableParts(clonedSheet, numTableDefParts);
//There should only be one sheet that has focus
CleanView(clonedSheet);
...
}

Очистка представления предполагает удаление ссылок на представление из клонированного листа.

static void CleanView(WorksheetPart worksheetPart)
{
//There can only be one sheet that has focus
SheetViews views = worksheetPart.Worksheet.GetFirstChild<SheetViews>();
if (views != null)
{
views.Remove();
worksheetPart.Worksheet.Save();
}
}

Исправление разделов таблиц предполагает проверку наличия у каждой таблицы уникального имени и идентификатора.

static void FixupTableParts(WorksheetPart worksheetPart, int numTableDefParts)
{
//Every table needs a unique id and name
foreach (TableDefinitionPart tableDefPart in worksheetPart.TableDefinitionParts)
{
tableId++;
tableDefPart.Table.Id = (uint)tableId;
tableDefPart.Table.DisplayName = "CopiedTable" + tableId;
tableDefPart.Table.Name = "CopiedTable" + tableId;
tableDefPart.Table.Save();
}
}

Все в порядке. Последний шаг — это добавление ссылки на добавленный лист в основной раздел книги с помощью следующего кода:

static void CopySheet(string filename, string sheetName, string clonedSheetName)
{
...
//Add new sheet to main workbook part
Sheets sheets = workbookPart.Workbook.GetFirstChild<Sheets>();
Sheet copiedSheet = new Sheet();
copiedSheet.Name = clonedSheetName;
copiedSheet.Id = workbookPart.GetIdOfPart(clonedSheet);
copiedSheet.SheetId = (uint)sheets.ChildElements.Count + 1;
sheets.Append(copiedSheet);
//Save Changes
workbookPart.Workbook.Save();
...
}

Заключение

Объединив все фрагменты и выполнив предложенный код, мы получим книгу с четырьмя листами, где последний лист, названный "CopiedData", является точной копией первого листа.

Вот снимок экрана с созданной книгой:

Снимок экрана с книгой Excel после выполнения кода

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/02/19/how-to-copy-a-worksheet-within-a-workbook.aspx.]]> Пакет Open XML SDK: основные сведения https://docs.microsoft.com/archive/blogs/brian_jones_ru/open-xml-sdk Thu, 02 Jul 2009 17:37:19 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/open-xml-sdk/ Привет! Меня зовут Али. Я являюсь разработчиком в команде разработчиков Word. Я также работал над функциональностью пакета Open XML SDK и в этой публикации хочу подробнее рассказать о пакете SDK и лежащей в его основе концепции.

В своих записях Зияд Раджаби (Zeyad Rajabi) и Эрик Уайт (Eric White) продемонстрировали множество отличных решений (например, "Использование преимущества связанных элементов управления содержимым" и "Принятие исправлений и удаление примечаний из документа SharePoint"), которые можно построить с помощью пакета Open XML SDK для создания, чтения или изменения документов, электронных таблиц и презентаций. В каждой записи присутствовал сценарий и был продемонстрирован код для его реализации. Здесь я хочу более подробно обсудить содержимое пакета SDK и то, чем обусловлены некоторые из представленных в нем подходов. У меня нет сценария, есть лишь некоторые заметки, дающие представление о том, из чего состоит пакет SDK и почему.

Я работаю над Word, поэтому все мои примеры будут касаться компонентов WordProcessingML, хотя все представленное применимо и к другим форматам.

Это всего лишь XML!

Помимо пакетов и разделов пакет SDK включает иерархию типов, таких как Paragraph. Для успешного использования SDK важно знать, что эти классы всего лишь представляют элементы XML и действуют так же, но с несколько большей интеграцией с типами.

В корне иерархии располагается (абстрактный) класс OpenXMLElement. Класс OpenXMLElement программно представляет любой старый элемент, фигурирующий в файле Open XML. Имя его довольно ясно представляет элемент XML. Предоставленные методы и свойства также соответствуют ожиданиям в отношении элементов XML: .FirstChild, .InnerText, .NextSibling(), Append(OpenXMLElement) и т.д.

Класс OpenXMLElement сам по себе предоставляет некоторые функции (как все хорошие базовые классы), которые мы рассмотрим ниже, но производные от него классы представляют больший интерес. Для каждого элемента, указанного в спецификации Open XML, существует соответствующий класс в SDK, производный (опосредовано) от класса OpenXMLElement. Во-первых, существует еще два абстрактных класса, предназначенных для того, чтобы отличать элементы, которые могут иметь другие элементы в качестве дочерних и те, которые не могут, — это классы OpenXMLCompositeElement и OpenXMLLeafElement.

Класс Paragraph, например, является производным от класса OpenXMLCompositeElement. "Ну и что?" — спросите вы. Хорошо, начнем с простого. Если вам приходилось писать код, управляющий объектами XmlElement, вы знаете, как трудно постоянно сверять имя и пространство имен, чтобы определить, с каким элементом вы в данный момент работаете. Благодаря иерархии типов, представляющей элементы, вы всегда получаете наиболее производный тип для элемента из методов Open XML SDK, возвращающих объекты OpenXMLElement. Например, свойство Body.FirstChild возвращает экземпляр класса Paragraph, если первый дочерний элемент элемента w:body в считываемом документе действительно является элементом w:p. В противном случае возвращается какой-либо другой тип. Так, вместо проверки имени и пространства имен элемента можно проверить его тип, например:

Paragraph p = child as Paragraph;
if (p != null)
{
// Do something ...
}

Я хочу лишний раз подтвердить, что тут нет никакой магии. Пакет SDK действительно проверил имя и пространство имен для выбора класса Paragraph подобно тому, как сделал бы ваш код. Дополнительное преимущество заключается в том, что вам не надо каждый раз писать эти проверки самостоятельно. Конечно, наличие типа имеет и другие преимущества. Для начала можно написать функции, принимающие аргумент типа Paragraph, а компилятор будет следить за выполнением этого контракта вместо вас.

Более того, когда элементы различаются по типу, можно использовать универсальные типы для обеспечения большей чистоты кода. Помните, что я упоминал о том, что OpenXMLElement сам по себе обладает некоторыми полезными функциями? Взгляните на метод GetFirstChild<T>, где T является производным от OpenXMLElement. Как можно представить, этот метод возвращает первый дочерний элемент, принадлежащий определенному типу. Снова все, что делает SDK, это проверяет имя и пространство имен вместо вас, но полученная очистка кода существенна. Descendants<T>(), RemoveAllChildren<T>(), ReplaceChild<T>(), Ancestors<T>() и прочие методы действуют подобным образом.

Еще одним преимуществом наличия этих типов является возможность использования ключевого слова "new". Хотите создать элемент w:b (полужирный)? Просто сделайте это:

Bold b = new Bold();

Помните, что это просто особый способ работы с XML. Что я сделал? Я создал элемент XML в пространстве имен WordProcessingML (конечно, в зависимости от того, в какой оператор using разрешается тип Bold) с именем "b". Этот элемент еще не принадлежит какому-либо документу, его необходимо добавить (с помощью метода InsertAfter, AppendChild и т.д.).

Наличие спецификации Open XML позволило пакету SDK представлять отдельные элементы как собственные типы и добавлять функции, упрощающие обработку элементов благодаря их типам.

Свойства первого класса

До этого момента мы использовали схему только как список имен и пространств имен элементов, хотя этот список и был очень большим. Схема сообщает нам гораздо больше, в частности, какие элементы и атрибуты допустимы в качестве дочерних для того или иного элемента. Например, элемент w:sdt (тег структуры документа уровня последовательности знаков) в WordProcessingML может иметь максимум один дочерний элемент типа w:sdtPr (свойства SDT). Учитывая изложенное выше, мы можем использовать универсальный метод GetFirstChild<T>() для поиска этого элемента свойств следующим образом:

SdtProperties sdtPr = sdtRun.GetFirstChild<SdtProperties>();
if (sdtPr != null)
{
// Do something ...
}

Следует заметить, что нам не надо приводить возвращаемое значение GetFirstChild. Это лучше, чем циклический перебор всех дочерних элементов с проверкой имен и пространств имен с целью поиска элемента sdtPr, но по-прежнему не самый простой способ, поскольку он требует повтора действий на каждом уровне. Класс SdtRun в SDK имеет свойство SdtProperties, представляющее этот дочерний элемент. Таким образом, фрагмент кода будет иметь следующий вид:

SdtProperties sdtPr = sdtRun.SdtProperties;
if (sdtPr != null)
{
// Do something ...
}

Это свойство доступно для чтения и записи. Теперь возьмем объект RunProperties.

RunProperties rPr = new RunProperties();
rPr.Italic = new Italic();
rPr.Bold = new Bold();
rPr.NoProof = new NoProof();

Что произошло? Мы создали элемент w:rPr и присвоили его свойство Bold новому экземпляру класса Bold. При этом был создан элемент w:b, который при присвоении был присоединен в качестве дочернего к нашему элементу rPr. То же происходит и со свойствами Italic и NoProof. Снова никакой магии тут нет, это всего лишь сокращенные варианты операций, выполняемых как операции с исходным кодом XML, позволяющие значительно сократить и упростить код.

В этих четырех строках скрыта еще более ценная функция. Ниже представлен аналогичный код, но без использования свойств первого класса. Что тут не так?

RunProperties rPr = new RunProperties();
rPr.AppendChild(new Italic());
rPr.AppendChild(new Bold());
rPr.AppendChild(new NoProof());

Этот фрагмент кода создает документ с недопустимой схемой. В схеме указаны дочерние элементы элемента rPr как последовательность, поэтому порядок имеет значение. Согласно схеме, чтобы файл был допустимым, Bold (w:b) должен следовать перед Italics (w:i). Фрагмент кода, в котором использовано присвоение свойств, выполняет эту задачу правильно (поскольку фоновый код присвоений "знает" о порядке, которому должен подчиняться второй код).

Теперь подведем итог того, что мы увидели в примерах. Если схема разрешает использование только одного экземпляра дочернего элемента, в класс, представляющий родительский элемент, добавляется свойство этого типа и с тем же именем. Значение свойства может быть доступно для чтения или записи, а присвоение свойству добавляет (или переопределяет) дочерний элемент по отношению к родительскому.

А как же атрибуты? Атрибуты по определению отвечают приведенным выше критериям (каждый атрибут в каждом элементе может фигурировать не более одного раза). Так, атрибуты, объявленные в схеме, всегда получают свойства первого класса. Например, к приведенным выше свойствам выполнения мы можем добавить Underline.

RunProperties rPr = new RunProperties();
rPr.Italic = new Italic();
rPr.Bold = new Bold();
rPr.Underline = new Underline();
rPr.Underline.Val = UnderlineValues.DotDotDash;

Последняя строка представляет наибольший интерес. Во-первых, обратите внимание на свойство Val в элементе Underline. Оно представляет атрибут w:val этого элемента. Как обычно, выполняя присвоение этому свойству, мы создаем экземпляр атрибута и помещаем его в элемент. Значения атрибута, конечно, строковые, но, если схема указывает, что они являются членами перечисления, SDK также содержит соответствующее перечисление CLR. Имя перечисления создается таким, чтобы оно было узнаваемо: например, TypeValues. Здесь можно долго говорить о специфике и "удобстве" синтаксиса присвоения, предполагающего неявные конструкторы и прочее, но я оставлю это для самостоятельного изучения читателями. Укажу лишь на то, что атрибут Val здесь жестко типизирован. Следующий оператор скомпилирован не будет:

rPr.Underline.Val = BooleanValues.False;

Это всего лишь XML! Правда!

Ладно, вернемся к началу. Я надеюсь, что мне удалось продемонстрировать, как SDK добавляет значение, используя компактные и простые способы, позволяющие создавать более понятный и чистый код для создания, чтения файлов Open XML и работы с ними. В заключение упомяну еще некоторые моменты.

  • Не позволяйте свойствам вводить вас в заблуждение, считая, что объекты всегда присутствуют. В действительности вы оперируете элементами и атрибутами XML и порой они просто отсутствуют. rPr.Underline может вернуть значение NULL, например, если w:rPr не имеет дочернего элемента Underline. Даже если значение не NULL, rPr.Underline.Val может вернуть значение NULL, если элемент присутствует, но отсутствует атрибут Val.
  • Создавать элементы с помощью ключевого слова "new" очень просто и интересно, но даже такой способ может оказаться трудоемким из-за большого размера иерархии элементов, в частности, когда создаваемые элементы подобны. Например, представьте, что вашему приложению требуется добавить таблицу в документ. Кроме того, первые три строки таблицы всегда одинаковы (скажем, заголовок). Вместо создания объекта Table, трех объектов Row и множества объектов Cell для каждого из объектов Row с последующим добавлением ячеек в строки, а строк — в таблицу, можно просто воспользоваться конструкцией, предоставленной классом Table, которая использует в качестве входящего значения строку XML. Конечно, предоставляемый XML должен иметь надлежащий формат (т.е. необходимо будет закрыть теги w:tbl и т.д.), но затем можно будет добавить в полученный объект Table дополнительные строки.
  • LINQ. В большинстве примеров, приведенных Зиядом и Эриком, используется исключительно LINQ. Хотя Open XML SDK разрабатывался для работы с LINQ, явного требования использовать LINQ здесь нет. Как правило, при создании элементов XML (таких, как приведенные выше примеры с элементом rPr) простой императивный код оказывается более удобочитаемым, чем аналоги LINQ. Точно так же запросы LINQ (лишний раз повторюсь) оказываются короче, когда необходимо задать такой простой вопрос, как "содержит ли этот документ какие-либо теги SDT с данным значением псевдонима?".

-Али

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/01/12/open-xml-sdk-the-basics.aspx.]]> Удаление примечаний из файлов Excel и PowerPoint https://docs.microsoft.com/archive/blogs/brian_jones_ru/excel Thu, 02 Jul 2009 17:37:15 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/excel/ В предыдущей записи я показал, как удалять примечания из файла Word. Сегодня я продемонстрирую, как выполняется этот же сценарий, но с файлами Excel и PowerPoint. В Excel и PowerPoint есть функция "Инспектор документов", которая позволяет удалять различные типы данных и содержимого, включая примечания. Эта функция очень хорошо работает в клиентских решениях, но как выполнить очистку файлов от примечаний на сервере? Open XML SDK может справиться с этой задачей с помощью всего нескольких строк кода.

Примечание. Представленный здесь код обратно совместим с версией 1 пакета SDK.

Решение для PowerPoint

Допустим, я начинаю работу с презентацией PowerPoint, содержащей множество слайдов и примечаний. Вот снимок экрана, на котором изображены примечания внутри слайда PowerPoint:

Для удаления примечаний из презентации PowerPoint необходимо выполнить следующие действия:

  1. Открыть презентацию PowerPoint с помощью пакета Open XML SDK.
  2. Получить доступ к главному разделу презентации, который предоставляет доступ ко всем разделам слайдов в пакете.
  3. Удалить раздел примечаний, связанный с каждым разделом слайда.
  4. Сохранить изменения презентации.

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

Код довольно простой и полностью соответствует перечисленным выше шагам.

static void RemovePowerPointComments(string filename)
{
using (PresentationDocument myPresentation = PresentationDocument.Open(filename, true))
{
PresentationPart presentationPart = myPresentation.PresentationPart;
foreach (SlidePart slide in presentationPart.SlideParts)
{
slide.DeletePart(slide.SlideCommentsPart);
}
}
}

Заключение

Выполнив этот метод, мы получим презентацию без примечаний. Легко!

Вот снимок экрана с итоговой презентацией:

Решение для Excel

Это решение очень похоже на решение для PowerPoint.

Допустим, у нас есть книга Excel с множеством листов, каждый из которых содержит несколько примечаний. Вот снимок экрана, на котором изображено примечание в ячейке листа:

Для удаления примечаний из книги Excel необходимо выполнить следующие действия:

  1. Открыть книгу Excel с помощью пакета Open XML SDK.
  2. Получить доступ к главному разделу книги, который предоставляет доступ ко всем разделам листов в пакете.
  3. Удалить все примечания, связанные с каждым разделом листа.
  4. Сохранить изменения в книге.

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

Код очень похож на код, используемый для удаления примечаний из презентации PowerPoint.

static void RemoveExcelComments(string filename)
{
using (SpreadsheetDocument myWorkbook = SpreadsheetDocument.Open(filename, true))
{
WorkbookPart workbookPart = myWorkbook.WorkbookPart;
foreach (WorksheetPart sheet in workbookPart.WorksheetParts)
{
sheet.DeleteParts<WorksheetCommentsPart>(sheet.GetPartsOfType<WorksheetCommentsPart>());
}
}
}

Заключение

Выполнив этот метод, мы получим книгу без примечаний.

Вот снимок экрана с итоговой книгой:

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/04/20/removing-comments-from-excel-and-powerpoint-files.aspx.]]> Импорт диаграмм из электронных таблиц в текстовые документы https://docs.microsoft.com/archive/blogs/brian_jones_ru/93 Thu, 02 Jul 2009 17:37:13 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/93/ Многие читатели спрашивают, как можно импортировать диаграмму из документа одного типа в документ другого типа. В своей прошлой записи блога я показал, как поместить данные в таблицу для создания диаграммы. Сегодня я продемонстрирую процедуру импорта диаграммы из электронной таблицы в документ Word.

Решение

Для импорта диаграммы из электронной таблицы в документ Word потребуется выполнить следующие действия:

  1. Создать в программе Word шаблон, содержащий элемент управления содержимым, который будет определять область для вставки диаграммы.
  2. Открыть созданный документ Word с помощью пакета Open XML SDK и получить доступ к главному разделу документа.
  3. Найти элемент управления содержимым, в котором планируется разместить диаграмму.
  4. Удалить все замещающее содержимое в этом элементе управления.
  5. Создать новый экземпляр класса Run и встроенный объект-рисунок для вставки в данный элемент управления содержимым. Этот встроенный объект-рисунок будет содержать ссылочные сведения для диаграммы.
  6. Открыть электронную таблицу с помощью пакета Open XML SDK и получить доступ к соответствующим разделам (к главному разделу книги, разделам электронной таблицы, рисунка и диаграммы).
  7. Скопировать раздел диаграммы и добавить его в документ Word.
  8. Скопировать графические сведения о диаграмме (имя диаграммы и ее свойства) из электронной таблицы и добавить их в документ Word.
  9. Присвоить диаграмме в документе Word уникальные имя и идентификатор.
  10. Добавить данные диаграммы в элемент управления содержимым.
  11. Сохранить изменения документа Word.

В моей демонстрации будет использоваться пакет SDK версии 2.

Чтобы более наглядно представить изложенный здесь материал, начнем работать со следующей электронной таблицей и диаграммой:

Кроме того, мы будем использовать следующий документ Word, содержащий замещающий элемент управления содержимым:

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

Как уже указывалось в разделе "Решение" выше, шаги 2–4 включают открытие документа Word, поиск элемента управления содержимым, в котором будет помещена импортированная диаграмма, и удаление замещающего содержимого этого элемента управления для подготовки к вставке диаграммы. Взгляните на фрагмент кода, в котором реализуется выполнение этих задач:

static void ImportChartFromSpreadsheet(string spreadsheetFileName, string wordFileName)
{
//Open Word document
using (WordprocessingDocument myWordDoc = WordprocessingDocument.Open(wordFileName, true))
{
//Find the content control that will contain the chart
MainDocumentPart mainPart = myWordDoc.MainDocumentPart;
SdtBlock sdt = mainPart.Document.Descendants<SdtBlock>()
.Where(s => a.SdtProperties.GetFirstChild<Alias>().Val.Value
.Equals("Chart1")).First();
//Nuke the placeholder content of the content control
Paragraph p = sdt.SdtContentBlock.GetFirstChild<Paragraph>();
p.RemoveAllChildren();
...
}
}

Вы, наверно, заметили, что код, используемый для поиска соответствующего элемента управления содержимым, очень напоминает код, продемонстрированный в моей предыдущей записи для объединения документов Word. Чтобы подготовить элемент управления к вставке диаграммы, внутри него удаляются все дочерние элементы класса Paragraph.

Вместо работы с экземпляром класса Run и текстовыми элементами для данного элемента управления содержимым требуется создать экземпляр класса Run и встроенный объект-рисунок, необходимый для создания правильной ссылки на диаграмму. Эта задача выполняется с помощью следующего фрагмента кода:

//Create a new run that has an inline drawing object
Run r = new Run();
p.Append(r);
Drawing drawing = new Drawing();
r.Append(drawing);
//These dimensions work perfectly for my template document
wp.Inline inline = new wp.Inline(
new wp.Extent()
{ Cx = 5486400, Cy = 3200400 });

Обратите внимание, что размеры импортируемой диаграммы в моем коде жестко заданы. Я ввел те размеры, которые, как мне кажется, лучше всего подходят к шаблону. Вы можете использовать любые размеры, соответствующие вашему документу. На данном этапе документ Word полностью готов для импорта диаграммы и ее вставки в элемент управления содержимым. Для импорта диаграммы необходимо получить доступ к соответствующему разделу диаграммы, а затем добавить этот раздел в документ Word. Эти задачи реализованы в следующем фрагменте кода:

//Open Excel spreadsheet
using (SpreadsheetDocument mySpreadsheet =
SpreadsheetDocument.Open(spreadsheetFileName, true))
{
//Get all the appropriate parts
WorkbookPart workbookPart = mySpreadsheet.WorkbookPart;
WorksheetPart worksheetPart = (WorksheetPart)workbookPart.GetPartById("rId1");
DrawingsPart drawingPart = worksheetPart.DrawingsPart;
ChartPart chartPart = (ChartPart)drawingPart.GetPartById("rId1");
//Clone the chart part and add it to my Word document
ChartPart importedChartPart = mainPart.AddPart<ChartPart>(chartPart);
string relId = mainPart.GetIdOfPart(importedChartPart);
...
}

Раздел диаграммы теперь входит в состав пакета документа Word. Нам осталось только правильно создать ссылку на этот раздел из встроенного объекта-рисунка, который находится внутри элемента управления содержимым. Чтобы наш код заработал, потребуется выполнить две задачи.

  1. Создать графическую ссылку на раздел диаграммы.
  2. Присвоить каждой диаграмме уникальные идентификатор и имя.

Выполнение первой задачи не составляет никакого труда, поскольку можно повторно использовать те же графические объекты из электронной таблицы. Однако потребуется убедиться, что отношение ссылается на соответствующий раздел диаграммы в документе Word (именно в этом и состоит главное отличие). Вот фрагмент кода, в котором реализуется первая задача:

//The frame element contains information for the chart
GraphicFrame frame =
drawingPart.WorksheetDrawing.Descendants<GraphicFrame>().First();
string chartName = frame.NonVisualGraphicFrameProperties.NonVisualDrawingProperties.Name;
//Clone this node so we can add it to my Word document
d.Graphic clonedGraphic = (d.Graphic)frame.Graphic.CloneNode(true);
ChartReference c = clonedGraphic.GraphicData.GetFirstChild<ChartReference>();
c.Id = relId;


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

static uint GetMaxDocPrId(MainDocumentPart mainPart)
{
uint max = 1;
//Get max id value of docPr elements
foreach (wp.DocProperties docPr in mainPart.Document.Descendants<wp.DocProperties>())
{
uint id = docPr.Id;
if (id > max)
max = id;
}
return max;
}

Мы почти закончили! Теперь остается только присвоить уникальные имя и идентификатор рисунку диаграммы и добавить все это во встроенный объект-рисунок. Эти задачи выполнены в следующем фрагменте кода:

//Give the chart a unique id and name
wp.DocProperties docPr = new wp.DocProperties();
docPr.Name = chartName;
docPr.Id = GetMaxDocPrId(mainPart) + 1;
//add the chart data to the inline drawing object
inline.Append(docPr, clonedGraphic);
drawing.Append(inline);

Заключение

Собрав вместе все показанные фрагменты и запустив итоговый код, мы получим документ Word, который содержит диаграмму, импортированную из электронной таблицы.

Взгляните на снимок экрана, на котором показан окончательный документ:

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/03/13/importing-charts-from-spreadsheets-to-wordprocessing-documents.aspx.]]> Удаление примечаний из текстового документа программными средствами https://docs.microsoft.com/archive/blogs/brian_jones_ru/103 Thu, 02 Jul 2009 17:37:03 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/103/ Один из наиболее распространенных сценариев, связанных с текстовыми документами, заключается в очистке документа с целью удаления любых содержащихся в нем личных сведений. Что я подразумеваю под личными сведениями? В первую очередь, я имею в виду примечания, редакции, персональные данные, такие как имя автора и скрытый текст. Этот тип содержимого часто требуется вычистить из документа, прежде чем он будет опубликован за пределами компании.

Этот сценарий настолько важен для программ Office, что в пакете Office 2007 мы добавили новый компонент под названием "Document Inspector", который способен находить и удалять любые личные сведения. Чтобы открыть этот компонент, необходимо нажать кнопку Office и последовательно выбрать "Prepare", "Inspect Document". Вот как выглядит окно инспектора документов:

А как выполнить те же действия программными средствами, скажем, на сервере? Здесь как раз нам может помочь пакет Open XML SDK. Сегодня я собираюсь продемонстрировать процедуру удаления примечаний из текстового документа. Данная запись аналогична записи Эрика по поводу использования LINQ для удаления примечаний из документа с тем отличием, что мое решение будет построено на основе пакета Open XML SDK версии 2.

Документ

Представим себе, что имеется документ, содержащий несколько примечаний, и некоторые из них могут включать изображения. Открыв соответствующий пакет, вы заметите, что в нашем текстовом документе с примечаниями имеется следующее содержимое:

  • Документ будет включать раздел примечаний с содержимым каждого примечания.
  • Раздел примечаний также может содержать ссылки на другие разделы, связанные с данным примечанием. Например, если примечание содержит изображение, раздел примечаний будет ссылаться на раздел изображений.
  • Главный раздел документа будет содержать ссылки на примечания посредством элементов ссылки на примечание.
  • Области, связанные с примечаниями, определяются в главном разделе с помощью начального и конечного элементов диапазона примечаний.

На следующем снимке экрана показан пример документа с примечаниями:

Решение

Для удаления примечаний из текстового документа потребуется выполнить следующие действия:

  1. Открыть текстовый документ с помощью пакета Open XML SDK.
  2. Получить доступ к главному разделу документа, из которого можно перейти ко всем другим разделам пакета.
  3. Удалить раздел примечаний и все разделы, на которые в нем имеются ссылки.
  4. Найти в главном разделе документа все элементы, связанные с примечаниями.
  5. Удалить все найденные элементы.
  6. Сохранить изменения документа.

В моей демонстрации будет использоваться пакет SDK версии 2.

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

В следующем фрагменте кода реализованы все шесть задач, рассмотренных выше в разделе Решение. В этом коде используются некоторые результаты, полученные в записях Переходы в модели DOM пакета Open XML SDK и Open XML SDK: основные сведения. В частности, для поиска конкретных элементов, связанных с примечаниями, используется метод Descendants(), а для работы с этими элементами — универсальный класс OpenXmlElement. Кроме того, необходимо заметить, что при удалении раздела с помощью пакета Open XML SDK вместе с этим разделом удаляются все разделы, на которые в нем имеются ссылки.

static void RemoveComments(string filename)
{
//Open up the document
using (WordprocessingDocument myDoc = WordprocessingDocument.Open(filename, true))
{
//Access main document part
MainDocumentPart mainPart = myDoc.MainDocumentPart;
//Delete the comment part, plus any other part referenced, like image parts
mainPart.DeletePart(mainPart.WordprocessingCommentsPart);
//Find all elements that are assoicated with comments
IEnumerable<OpenXmlElement> elementList = mainPart.Document.Descendants()
.Where(el => el is CommentRangeStart ||
el is CommentRangeEnd ||
el is CommentReference);
//Delete every found element
foreach (OpenXmlElement e in elementList)
{
e.Remove();
}
//Save changes
mainPart.Document.Save();
}
}

Заключение

Объединив и запустив итоговый код, мы получим документ, полностью очищенный от примечаний. Великолепно!

Взгляните на снимок экрана, на котором показан окончательный документ:

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/02/06/removing-comments-from-a-wordprocessing-document-programmatically.aspx.]]> Объединение нескольких презентаций PowerPoint https://docs.microsoft.com/archive/blogs/brian_jones_ru/113 Thu, 02 Jul 2009 17:37:01 GMT https://blogs.msdn.microsoft.com/brian_jones_ru/2009/07/02/113/ Я хочу предупредить вас, друзья, что в настоящее время мы работаем над устранением ряда неполадок на сервере, и поэтому в некоторых предыдущих записях могут не отображаться изображения или ссылки на исходный код. Надеюсь, эти неполадки будут скоро исправлены.

В своей предыдущей записи я показал вам простой способ объединения нескольких документов Word. Сегодня я расскажу, как можно объединить несколько презентаций PowerPoint.

Решение

Для объединения двух презентаций — исходной и целевой — потребуется выполнить следующие действия:

  1. Открыть целевую презентацию с помощью пакета Open XML SDK и получить доступ к главному разделу презентации.
  2. Открыть исходную презентацию и получить доступ к ее главному разделу.
  3. Добавить все слайды исходной презентации в целевую презентацию, сохранив их порядок.
  4. Проверить наличие отношения между главным разделом целевой презентации и разделом макета образца слайдов для каждого добавленного слайда.
  5. Проверить наличие в главном разделе целевой презентации ссылки на каждый добавленный раздел макета образца слайдов.
  6. Проверить наличие в главном разделе целевой презентации ссылки на каждый добавленный раздел слайдов.
  7. Выполнить операцию очистки, чтобы обеспечить присвоение всем ссылкам на разделы макета слайдов уникальных идентификаторов.
  8. Сохранить изменения целевой презентации.

В моей демонстрации будет использоваться пакет SDK версии 2.

Чтобы более наглядно представить изложенный здесь материал, начнем работать со следующими двумя презентациями, в каждой из которых содержится по три слайда:

Destination Deck

Source Deck

Destination deck with three slides

Source deck with three slides

Если вы хотите отслеживать все этапы работы непосредственно по коду, наше решение можно без труда загрузить здесь.

Код

Как указывалось в разделе "Решение" выше, для выполнения первых трех шагов необходимо открыть целевую и исходную презентации, чтобы добавить каждый слайд исходной презентации в целевую презентацию. Взгляните на фрагмент кода, в котором реализуется выполнение этих задач:

static void MergeDecks(string sourceDeck, string destDeck)
{
int id = 1;
//Open up the destination deck
using (PresentationDocument myDestDeck = PresentationDocument.Open(destDeck, true))
{
PresentationPart destPresPart = myDestDeck.PresentationPart;
//Open up the source deck
using (PresentationDocument mySourceDeck = PresentationDocument.Open(sourceDeck, true))
{
PresentationPart sourcePresPart = mySourceDeck.PresentationPart;
//Need to get a unique ids for slide master and slide lists //(will use these later)
uniqueId = GetMaxIdFromChild(destPresPart.Presentation.SlideMasterIdList);
uint maxSlideId = GetMaxIdFromChild(destPresPart.Presentation.SlideIdList);
//Copy each slide in my source deck in order to my destination deck
foreach (SlideId slideId in
sourcePresPart.Presentation.SlideIdList)
{
SlidePart sp;
SlidePart destSp;
SlideMasterPart destMasterPart;
string relId;
SlideMasterId newSlideMasterId;
SlideId newSlideId;
//come up with a unique relationship id
id++;
sp = (SlidePart)sourcePresPart
.GetPartById(slideId.RelationshipId);
relId = sourceDeck.Remove(sourceDeck.IndexOf('.')) + id;
destSp = destPresPart.AddPart<SlidePart>(sp, relId);
//Add the slide part to the destination deck    
SlidePart destSp = destPresPart.AddPart<SlidePart>(sp, relId);
...
}
...
}
...
}
}

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

На данном этапе мы лишь выполнили импорт раздела слайдов в целевую презентацию. Нашей следующей задачей будет установление отношения между главным разделом целевой презентации и добавленным разделом образцов слайдов. И здесь мы воспользуемся возможностями метода AddPart для добавления этого отношения с помощью следующего кода (метод AddPart устанавливает отношения, если раздел уже существует в пакете):

//Master part was added, but now we need to make sure the relationship is in place
destMasterPart = destSp.SlideLayoutPart.SlideMasterPart;
destPresPart.AddPart(destMasterPart);

Наш следующий шаг заключается в добавлении списка идентификаторов разделов образцов слайдов и идентификаторов слайдов в соответствующие списки главного раздела целевой презентации. Идентификаторы, указанные в каждом из этих списков, должны быть уникальными. Кроме того, существует дополнительное ограничение, которое состоит в том, что списки идентификаторов образцов слайдов и идентификаторов макетов слайдов должны содержать только уникальные значения, которые больше или равны 2147483684. Для выполнения этих требований уникальности необходим метод, который позволяет извлекать текущее максимальное значение идентификатора в списке. В таком случае при каждом добавлении нового элемента в список нам будет достаточно прибавить единицу к максимальному значению идентификатора. Ниже показан универсальный метод извлечения максимального значения из набора дочерних элементов.

static uint GetMaxIdFromChild(OpenXmlElement el)
{
uint max = 1;
//Get max id value from set of children
foreach (OpenXmlElement child in el.ChildElements)
{
OpenXmlAttribute attribute = child.GetAttribute("id", "");
    
uint id = uint.Parse(attribute.Value);
if (id > max)
max = id;
}
return max;
}

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

//Add slide master to slide master list
uniqueId++;
newSlideMasterId = new SlideMasterId();
newSlideMasterId.RelationshipId = destPresPart.GetIdOfPart(destMasterPart);
newSlideMasterId.Id = uniqueId;
//Add slide to slide list
maxSlideId++;
newSlideId = new SlideId();
newSlideId.RelationshipId = relId;
newSlideId.Id = maxSlideId;
destPresPart.Presentation.SlideMasterIdList.Append(newSlideMasterId); destPresPart.Presentation.SlideIdList.Append(newSlideId);

Мы почти закончили! Теперь нам осталось только проверить уникальность всех идентификаторов макетов слайдов. Как уже упоминалось, значения этих идентификаторов не должны совпадать со значениями списка идентификаторов разделов образцов слайдов. Кроме того, необходимо убедиться, что эти идентификаторы больше или равны 2147483684. Ниже показан метод, который перебирает все разделы образцов слайдов и устанавливает идентификаторы всех макетов слайдов, на которые имеются ссылки, простым увеличением значений идентификаторов на основе максимального значения uint, определенного на данный момент.

static void FixSlideLayoutIds(PresentationPart presPart)
{
//Need to make sure all slide layouts have unique ids
foreach (SlideMasterPart slideMasterPart in presPart.SlideMasterParts)
{
foreach (SlideLayoutId slideLayoutId in slideMasterPart.SlideMaster.SlideLayoutIdList)
{
uniqueId++;
slideLayoutId.Id = (uint)uniqueId;
}
slideMasterPart.SlideMaster.Save();
}
}

Заключение

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

Взгляните на снимок экрана, на котором показана окончательная презентация:

Итоговая объединенная презентация с шестью слайдами

Зияд Раджаби (Zeyad Rajabi)

Это локализованная запись блога. Исходную статью можно найти по адресу https://blogs.msdn.com/brian_jones/archive/2009/03/05/how-to-assemble-multiple-powerpoint-decks.]]>