📦 IrbyImaging.BLUtility.csproj Documentation
Project File: IrbyImaging.Utility/IrbyImaging.BLUtility.csproj
SDK: Microsoft.NET.Sdk
Target Framework: .NET 9.0 (net9.0)
📚 Table of Contents
- Overview & Purpose
- Key Functional Areas
- Dependencies & Technologies
- Key Project Elements
- Sample .csproj Snippet
- Usage Examples
- Mermaid Component Diagram
- Conclusion
🔍 Overview & Purpose
The IrbyImaging.BLUtility project is a .NET 9.0 class‐library that centralizes a wide variety of utility functions, third‐party integrations, and helper services for the IrbyImaging solution. It includes:
- Cloud integration (Azure Key Vault, Blob Storage)
- Document/report generation (PDF, Excel, Word, Syncfusion, BoldReports)
- OCR & Web Scraping (IronOCR, IronWebScraper)
- Authentication & Identity (OAuth2, OpenID Connect, Microsoft Identity)
- Data access (EF Core, SQL Server Management Objects)
- Automation & Scheduling (Quartz, Selenium)
- Email & Communication (MailKit, Outlook Interop, MimeKit)
Purpose: Provide a single reusable library for cross‐cutting concerns in IrbyImaging, reducing duplication and centralizing dependency management.
🧩 Key Functional Areas
- Configuration & Secrets Management
- Blob/File Storage
- Report & Document Generation
- Data Access & Encryption
- Authentication / Authorization
- Automation & Testing
- Email & Messaging
🛠️ Dependencies & Technologies
Below is a grouped catalogue of all NuGet packages referenced by the project. Each group highlights a major technology domain.
Azure & Cloud Services
| Package |
Version |
Purpose |
| Azure.Extensions.AspNetCore.Configuration.Secrets |
1.3.2 |
Load config from Azure Key Vault in ASP.NET Core apps. |
| Azure.Security.KeyVault.Secrets |
4.7.0 |
Client library for Azure Key Vault secret operations. |
| Azure.Storage.Blobs |
12.23.0 |
Azure Blob Storage SDK. |
| Microsoft.Extensions.Azure |
1.9.0 |
Simplified registration of Azure SDK clients. |
| Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
5.1.0 |
Always Encrypted support using Azure Key Vault. |
Reporting & Licensing
| Package |
Version |
Purpose |
| Bold.Licensing |
6.3.18 |
Licensing engine for BoldReports. |
| BoldReports.AspNet.Core |
6.3.18 |
Web‐based reporting components for ASP.NET Core. |
| BoldReports.Net.Core |
6.3.18 |
Core BoldReports APIs for .NET assemblies. |
| Package |
Version |
Purpose |
| ClosedXML |
0.104.2 |
Read/write Excel files (XLSX) without Microsoft Office. |
| IronPdf |
2024.12.9 |
Generate and manipulate PDF documents. |
| iTextSharp |
5.5.13.4 |
Popular PDF library for creation/manipulation. |
| IronXL.Excel |
2025.2.5 |
High‐performance Excel engine. |
| Syncfusion.XlsIO.Net.Core |
28.1.33 |
Syncfusion Excel library. |
| Syncfusion.Presentation.Net.Core |
28.1.33 |
PowerPoint file creation and manipulation. |
| Syncfusion.DocIO.Net.Core |
28.1.33 |
Word document processing. |
| Syncfusion.Pdf.Net.Core |
28.1.33 |
Syncfusion PDF creation library. |
| Syncfusion.Compression.Net.Core |
28.1.33 |
Compression/decompression utilities. |
| Syncfusion.XlsIORenderer.Net.Core |
28.1.33 |
Excel‐to‐PDF conversion. |
CSV, OCR & Web Scraping
| Package |
Version |
Purpose |
| CsvHelper |
33.0.1 |
Fast CSV read/write. |
| IronOcr |
2024.12.2 |
Optical Character Recognition (OCR). |
| IronWebScraper |
2024.12.1 |
High‐level web crawling/scraping. |
Authentication & Identity
| Package |
Version |
Purpose |
| Microsoft.AspNetCore.Authentication.OpenIdConnect |
9.0.0 |
OpenID Connect auth middleware. |
| Microsoft.Identity.Web |
3.5.0 |
Simplified Azure AD integration for ASP.NET Core. |
| Microsoft.Identity.Web.UI |
3.5.0 |
UI components for Microsoft.Identity.Web. |
| Microsoft.AspNetCore.Identity.EntityFrameworkCore |
9.0.0 |
Identity with EF Core stores. |
| Microsoft.AspNetCore.Identity.UI |
9.0.0 |
Razor UI for ASP.NET Core Identity. |
Code Analysis & Roslyn
| Package |
Version |
Purpose |
| Microsoft.CodeAnalysis.* (various) |
4.12.0 |
Roslyn compiler & workspace APIs. |
| Microsoft.CodeAnalysis.Analyzers |
3.11.0 |
Static code analysis. |
| Microsoft.CodeAnalysis.AnalyzerUtilities |
3.3.4 |
Helper utilities for analyzers. |
Data Access & EF Core
| Package |
Version |
Purpose |
| Microsoft.EntityFrameworkCore |
9.0.0 |
EF Core ORM for data access. |
| Microsoft.EntityFrameworkCore.SqlServer |
9.0.0 |
SQL Server provider for EF Core. |
| Microsoft.EntityFrameworkCore.InMemory |
9.0.0 |
In‐memory provider for testing. |
| Microsoft.EntityFrameworkCore.Tools |
9.0.0 |
Design‐time tools (migrations, scaffolding). |
Microsoft Services & Graph
| Package |
Version |
Purpose |
| Microsoft.Graph |
5.71.0 |
Microsoft Graph SDK for calling graph API. |
Email, Scheduling & Automation
| Package |
Version |
Purpose |
| MimeKit |
4.9.0 |
MIME message creation/parsing. |
| NETCore.MailKit |
2.1.0 |
MailKit wrapper for .NET Core. |
| Microsoft.Office.Interop.Outlook |
15.0.4797.1004 |
Outlook automation. |
| Quartz |
3.13.1 |
Job scheduling library. |
UI & Syncfusion Components
| Package |
Version |
Purpose |
| Syncfusion.EJ.AspNet.Core |
20.4.0.43 |
Essential JS UI components (legacy). |
| Syncfusion.EJ.Pivot |
20.4.0.43 |
PivotGrid & PivotChart (legacy). |
| Syncfusion.EJ.Export |
20.4.0.43 |
Exporting features (legacy). |
| Syncfusion.EJ2.AspNet.Core |
28.1.33 |
Essential JS2 UI components for ASP.NET Core. |
| Syncfusion.EJ2.PdfViewer.AspNet.Core.Windows |
28.1.33 |
PDF viewer for web apps. |
| Syncfusion.EJ2.Spreadsheet.AspNet.Core |
28.1.33 |
Spreadsheet control. |
| Syncfusion.EJ2.WordEditor.AspNet.Core |
28.1.33 |
Word editor control. |
| Syncfusion.Licensing |
28.1.33 |
Syncfusion licensing engine. |
Directory & SQL Management
| Package |
Version |
Purpose |
| Microsoft.SqlServer.ConnectionInfo.dll |
1.0.1 |
SQL Server SMO ConnectionInfo. |
| Microsoft.SqlServer.Smo.dll |
1.0.1 |
SQL Server Management Objects. |
| Microsoft.SqlServer.SqlManagementObjects |
172.52.0 |
SMO for advanced SQL Server management. |
| System.DirectoryServices |
9.0.0 |
LDAP / Active Directory access. |
| System.DirectoryServices.AccountManagement |
9.0.0 |
AD user/group management. |
| System.Data.SqlClient |
4.9.0 |
ADO.NET SQL Server provider. |
Utilities & Testing
| Package |
Version |
Purpose |
| Selenium.WebDriver |
4.27.0 |
Browser automation framework. |
| Selenium.Support |
4.27.0 |
Helper libraries for Selenium. |
| Selenium.WebDriver.ChromeDriver |
131.0.6778.20400 |
ChromeDriver for Selenium. |
| coverlet.collector |
6.0.2 |
Code coverage for unit tests. |
| Microsoft.NET.Test.Sdk |
17.12.0 |
Test SDK required by xUnit, NUnit, MSTest. |
| xunit.runner.visualstudio |
2.8.2 |
xUnit VS Test Explorer integration. |
🔑 Key Project Elements
-
TargetFramework:
Ensures compatibility with .NET 9.0.
-
PackageReference:
Defines all third‐party dependencies.
- Some references use
<PrivateAssets>all</PrivateAssets> to prevent transitively exposing testing/analysis packages.
-
ItemGroup:
Groups all package references in a clean, maintainable way.
📄 Sample .csproj Snippet
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<!-- Azure Key Vault + Storage -->
<PackageReference Include="Azure.Extensions.AspNetCore.Configuration.Secrets" Version="1.3.2" />
<PackageReference Include="Azure.Security.KeyVault.Secrets" Version="4.7.0" />
<PackageReference Include="Azure.Storage.Blobs" Version="12.23.0" />
<!-- Reporting & Licensing -->
<PackageReference Include="Bold.Licensing" Version="6.3.18" />
<PackageReference Include="BoldReports.AspNet.Core" Version="6.3.18" />
<PackageReference Include="BoldReports.Net.Core" Version="6.3.18" />
<!-- …and so on for 80+ packages… -->
</ItemGroup>
</Project>
⚙️ Usage Examples
- Restore packages
dotnet restore IrbyImaging.BLUtility.csproj
- Build
dotnet build IrbyImaging.BLUtility.csproj -c Release
- Reference in another project
<ProjectReference Include="..\IrbyImaging.Utility\IrbyImaging.BLUtility.csproj" />
- Leverage functionality
using IrbyImaging.Utility; // namespace containing your helpers
🗺️ Mermaid Component Diagram
graph LR
subgraph IrbyImaging.BLUtility
A[Configuration & Secrets]
B[Blob Storage]
C[Reporting & Documents]
D[Data Access]
E[Auth & Identity]
F[OCR & Scraping]
G[Email & Scheduling]
H[UI Components]
I[Testing & Automation]
end
A -->|uses| AzureKv[Azure Key Vault]
B -->|uses| Blob[Azure Blob Storage]
C -->|uses| BoldR[BoldReports]
C -->|uses| SyncfusionDocs[Syncfusion]
C -->|uses| iText[iTextSharp]
D -->|uses| EFCore
D -->|uses| SMO
E -->|uses| Identity
F -->|uses| IronOcr & IronWebScraper
G -->|uses| MailKit & Quartz
H -->|uses| Syncfusion.EJ2 UI
I -->|uses| Selenium & xUnit
🏁 Conclusion
The IrbyImaging.BLUtility project file is the cornerstone for orchestrating a rich ecosystem of utilities and integrations in your imaging solution. By centralizing:
- Cloud connectivity
- Document/report generation
- Data access & encryption
- Security & identity
- Automation & testing
…you gain a single, maintainable library that can evolve with your enterprise requirements.
🎉 Happy coding with IrbyImaging.BLUtility!