📦 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

  1. Overview & Purpose
  2. Key Functional Areas
  3. Dependencies & Technologies
  4. Key Project Elements
  5. Sample .csproj Snippet
  6. Usage Examples
  7. Mermaid Component Diagram
  8. 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.

Office Formats & PDF/Excel

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

  1. Restore packages
    dotnet restore IrbyImaging.BLUtility.csproj
    
  2. Build
    dotnet build IrbyImaging.BLUtility.csproj -c Release
    
  3. Reference in another project
    <ProjectReference Include="..\IrbyImaging.Utility\IrbyImaging.BLUtility.csproj" />
    
  4. 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!