ClosedXML

? Скачать нестабильную сборку CI

Blockxml - это библиотека .NET для чтения, манипулирования и написания файлов Excel 2007+ (.xlsx, .xlsm). Он направлен на то, чтобы обеспечить интуитивно понятный и удобный интерфейс для работы с базовым API OpenXML.

Для получения дополнительной информации см. Документацию или вики.

Руководство по выпуску и миграция

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

• Примечания к выпуску для 0,100
• Руководство по миграции для 0,100
• Примечания к выпуску для 0,97

Производительность

Производительность имеет значение в основном для больших файлов. Для небольших файлов мало MS здесь или там не имеет значения. Представленные данные, как правило, из разработки филиала (в настоящее время 0,103-бета).

Детали времени выполнения

`` `BenchmarkDotnet V0.13.8, Windows 11 (10.0.22621.2283/22H2/2022Update/sunvalley2) AMD Ryzen 55500U с графикой Radeon, 1 CPU, 12 Logical и 6 Physical Cores .NET SDK 8.0.100.1.1.13463.5. (7.0.1123.42427), x64 ryujit avx2 `` `` `` `` `` `` `` `` `` `` ``

Сохранять

Описание	Ряды	Колонны	Время/память для вставки данных	Сохранить рабочую книгу	Общее время/память
Смешанная (текст/номер) рабочая тетрадь. Суть	250 000	15	1,619 сек / 117 миб	6,343 сек	7,962 сек / 477 миб
Текст только рабочая книга. Суть	1 000 000	10	6,302 с / 402 миб	17.134 с	23.436 с / 1880 миб

Нагрузка

Описание	Ряды	Колонны	Время загрузки данных	Использовал память
Загрузите смешанную книгу (10 текстовых/5 столбцов номера).	250 000	15	15.648 с	236 миб
Текст только рабочая книга.	1 000 000	10	49.046 с	801 миб

Загрузите тесты используемые файлы, созданные во время теста сохранения.

Частые ответы

• Если вы получите исключение Unable to find font font name or fallback font fallback font name. Install missing fonts or specify a different fallback font through 'LoadOptions.DefaultGraphicEngine = new DefaultGraphicEngine(“Fallback font name”)' , см. Справочную страницу о пропущенных шрифтах.
• Closexml не безопасен. Нет никакой гарантии, что параллельные операции будут работать. Базовая библиотека OpenXML также не безопасна.
• Если вы получите исключение The type initializer for 'Gdip' threw an exception. На Linux вы должны обновить до 0,97+.

Установите закрытый XML через Nuget

Если вы хотите включить в свой проект Shallxml, вы можете установить его непосредственно из Nuget

Чтобы установить ClosedXML, запустите следующую команду в консоли диспетчера пакетов

 PM> Install-Package ClosedXML

Что вы можете с этим сделать?

Blockxml позволяет создавать файлы Excel без приложения Excel. Типичным примером является создание отчетов Excel на веб -сервере.

Пример:

 using ( var workbook = new XLWorkbook ( ) )
{
    var worksheet = workbook . Worksheets . Add ( "Sample Sheet" ) ;
    worksheet . Cell ( "A1" ) . Value = "Hello World!" ;
    worksheet . Cell ( "A2" ) . FormulaA1 = "=MID(A1, 7, 5)" ;
    workbook . SaveAs ( "HelloWorld.xlsx" ) ;
}

Расширения

Обязательно ознакомьтесь с нашими проектами по расширению ClosedXML

• https://github.com/closedxml/closedxml.report
• https://github.com/closedxml/closedxml.extensions.aspnet
• https://github.com/closedxml/closedxml.extensions.mvc
• https://github.com/closedxml/closedxml.extensions.webapi

Рекомендации разработчика

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

Пожалуйста, прочитайте полные руководящие принципы разработчика.

Кредиты

• Проект, первоначально созданный Мануэлем де Леоном
• Текущий сопровождающий: Ян Хавичик
• Бывший содействующий и ведущий разработчик: Франсуа Бота
• Мастер вычислительных шаблонов: aleksei pankratev
• Дизайн логотипа от @tobaloidee

Спасибо Jetbrains за предоставление инструментов разработки в рамках программы с открытым исходным кодом