Reo.Core.Report.ClosedXml 10.0.143

.NET 10.0

dotnet add package Reo.Core.Report.ClosedXml --version 10.0.143

NuGet\Install-Package Reo.Core.Report.ClosedXml -Version 10.0.143

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Reo.Core.Report.ClosedXml" Version="10.0.143" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Reo.Core.Report.ClosedXml" Version="10.0.143" />
                    

                            Directory.Packages.props

<PackageReference Include="Reo.Core.Report.ClosedXml" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Reo.Core.Report.ClosedXml --version 10.0.143

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Reo.Core.Report.ClosedXml, 10.0.143"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Reo.Core.Report.ClosedXml@10.0.143

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Reo.Core.Report.ClosedXml&version=10.0.143
                    

                            Install as a Cake Addin

#tool nuget:?package=Reo.Core.Report.ClosedXml&version=10.0.143
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Reo.Core.Report.ClosedXml

Описание пакета

Пакет Reo.Core.Report.ClosedXml предоставляет функционал для генерации отчётов в формате Excel (XLSX) с использованием библиотеки ClosedXML.Report. Он позволяет создавать динамические отчёты на основе шаблонов, применять фильтры данных и работать с метаданными отчётов.

Решаемые задачи:

Генерация Excel-отчётов на основе шаблонов.
Поддержка фильтрации данных для отчётов.
Управление метаданными (например, имя файла, байты отчёта, данные).
Интеграция с контейнером зависимостей (DI) через Microsoft.Extensions.DependencyInjection.

Основные компоненты

ReportDataFilter Базовый класс для фильтрации данных, используемый в интерфейсе IClosedXmlReportCreator.
ClosedXmlReportMetadata<TData> Класс, содержащий метаданные отчёта: имя файла, массив байтов Excel-файла и данные отчёта (TData).
IClosedXmlReportCreator<TData, TFilter> Интерфейс для создания отчётов. Требует реализации метода CreateAsync, который возвращает ClosedXmlReportMetadata<TData>.
BaseXlsxClosedXmlReportCreator<TData, TFilter> Абстрактный базовый класс, реализующий IClosedXmlReportCreator. Обеспечивает загрузку шаблонов, подготовку данных и сохранение отчёта в поток.
ServiceCollectionExtensions Методы расширения для регистрации сервисов в DI-контейнере. Используется для автоматической регистрации всех IClosedXmlReportCreator<,> в сборке.

Требования

.NET: Совместим с версиями .NET 8.0 и .NET 9.0.
Зависимости:
- ClosedXML (библиотека для работы с Excel).
- System.IO, System.Threading, System.Threading.Tasks (стандартные библиотеки .NET).

Установка

Используйте следующие команды для установки пакета:

# через NuGet Package Manager
Install-Package Reo.Core.Report.ClosedXml

# через .NET CLI
dotnet add package Reo.Core.Report.ClosedXml

Настройка

Регистрация сервисов в DI

В ASP.NET Core или любом проекте с DI, зарегистрируйте сервисы следующим образом:

services.AddReoClosedXmlDataImport<YourAssembly>();

Замените YourAssembly на сборку, содержащую реализации IClosedXmlReportCreator<,>.

Конфигурационные параметры

Путь к шаблону (PathToTemplate): Указывается в производном классе BaseXlsxClosedXmlReportCreator.
Имя выходного файла (OutputFileName): Также определяется в производном классе.
Запасной шрифт (FallbackFont): По умолчанию "Courier New".

Использование

Пример реализации

public class MyReportFilter : ReportDataFilter
{
    public string FilterValue { get; set; }
}

public class MyReportData
{
    public string Title { get; set; }
    public int Count { get; set; }
}

public class MyReportCreator : BaseXlsxClosedXmlReportCreator<MyReportData, MyReportFilter>
{
    protected override string PathToTemplate => "Templates/MyReportTemplate.xlsx";
    protected override string OutputFileName => "MyReport.xlsx";

    protected override async Task<MyReportData> PrepareDataAsync(MyReportFilter filter, CancellationToken token)
    {
        return new MyReportData
        {
            Title = "Отчёт за " + filter.FilterValue,
            Count = 42
        };
    }
}

Использование в приложении

var creator = new MyReportCreator();
var metadata = await creator.CreateAsync(new MyReportFilter { FilterValue = "2025" }, CancellationToken.None);

Лицензия

Данный пакет распространяется под лицензией MIT.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- ClosedXML (>= 0.105.0)
- ClosedXML.Report (>= 0.2.12)
- DocumentFormat.OpenXml (>= 3.5.1)
- FluentValidation (>= 12.1.1)
- FluentValidation.AspNetCore (>= 11.3.1)
- Flurl (>= 4.0.0)
- Flurl.Http (>= 4.0.2)
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.AspNetCore.Mvc.NewtonsoftJson (>= 10.0.7)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.7)
- Microsoft.Extensions.Configuration (>= 10.0.7)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.7)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.7)
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.7)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.7)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.7)
- Microsoft.Extensions.Http.Polly (>= 10.0.7)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.7)
- Microsoft.Extensions.Options (>= 10.0.7)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.7)
- Newtonsoft.Json (>= 13.0.4)
- Polly (>= 8.5.0)
- RedLock.net (>= 2.3.2)
- Reo.Core.Hosting (>= 10.0.143)
- stbychkov.AutoLoggerMessage (>= 1.0.15)
- Swashbuckle.AspNetCore (>= 10.1.7)
- System.Configuration.ConfigurationManager (>= 10.0.7)
- System.Linq.Async (>= 7.0.1)

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
10.0.143	36	5/8/2026
10.0.140	35	5/8/2026
10.0.139	39	5/8/2026
10.0.138	41	5/7/2026
10.0.135	30	5/7/2026
10.0.134	36	5/7/2026
10.0.133	29	5/7/2026
10.0.132	32	5/7/2026
10.0.131	38	5/7/2026
10.0.130	42	5/6/2026
10.0.129	40	5/6/2026
10.0.128	62	5/6/2026
10.0.127	81	5/5/2026
10.0.126	73	5/5/2026
10.0.125	100	4/27/2026
10.0.124	93	4/24/2026
10.0.120	91	4/24/2026
10.0.119	89	4/23/2026
10.0.117	92	4/23/2026
10.0.116	93	4/22/2026