Zongsoft.Core
7.50.1
dotnet add package Zongsoft.Core --version 7.50.1
NuGet\Install-Package Zongsoft.Core -Version 7.50.1
<PackageReference Include="Zongsoft.Core" Version="7.50.1" />
<PackageVersion Include="Zongsoft.Core" Version="7.50.1" />
<PackageReference Include="Zongsoft.Core" />
paket add Zongsoft.Core --version 7.50.1
#r "nuget: Zongsoft.Core, 7.50.1"
#:package Zongsoft.Core@7.50.1
#addin nuget:?package=Zongsoft.Core&version=7.50.1
#tool nuget:?package=Zongsoft.Core&version=7.50.1
Zongsoft Core
Overview
Zongsoft.Core is the foundation package of the Zongsoft Framework. It provides the shared abstractions, base types, utility APIs, and infrastructure building blocks used by the rest of the Zongsoft ecosystem.
The current project targets net8.0, net9.0, and net10.0, uses the root namespace Zongsoft, and is packaged as the Zongsoft.Core NuGet package. It integrates with the Microsoft.Extensions.* stack for dependency injection, configuration, options, hosting abstractions, object pooling, and memory caching.
Installation
dotnet add package Zongsoft.Core
What's Included
The package is intentionally broad: it is the common layer that higher-level Zongsoft packages build on. The main areas are:
| Area | Namespaces | Description |
|---|---|---|
| Common utilities | Zongsoft.Common |
Conversion helpers, random generation, sequences, predicates, timers, bit vectors, string/type/URI extensions, timestamps, locking helpers, and validation contracts. |
| Collections | Zongsoft.Collections |
Hierarchical nodes, category trees, parameter bags, synchronized collections, queues, object pools, and collection/dictionary extensions. |
| Components | Zongsoft.Components |
Command infrastructure, command-line parsing, event exchange, feature pipelines, retry/fallback/breaker/throttle/timeout features, state machines, workers, supervisors, handlers, executors, filters, converters, and identifiers. |
| Configuration | Zongsoft.Configuration |
Settings and connection settings, configuration binding and recognition, XML configuration providers, model-backed configuration, profile/INI parsing, and options integration with Microsoft.Extensions.Options. |
| Data abstractions | Zongsoft.Data |
Query criteria, conditions, ranges, paging, sorting, operands, model descriptors, data access/service contracts, operation options and events, metadata models, archiving contracts, and transaction primitives. |
| Services | Zongsoft.Services |
Application context and modules, service registration/discovery helpers, dependency metadata, modular services, service accessors, and distributed-lock abstractions. |
| Caching | Zongsoft.Caching |
In-memory cache wrappers, eviction/change events, cache scanner, distributed-cache contract, and the Spooler<T> batching helper. |
| Communication and messaging | Zongsoft.Communication, Zongsoft.Messaging |
Channel, listener, sender, receiver, requester/responder, transmitter, packetizer, notifier, message queue, producer/consumer, poller, and queue option abstractions. |
| Diagnostics and telemetry | Zongsoft.Diagnostics |
Logging contracts, console/text/XML loggers and formatters, diagnostic configuration, telemetry meters, metric descriptors, and exporter launcher contracts. |
| IO and hardware | Zongsoft.IO |
Virtual file-system contracts and local implementation, path parsing, MIME helpers, compression helpers, binary/text reader extensions, and hardware profile models. |
| Security | Zongsoft.Security |
Claims helpers, credentials, certificates, secret/signature contracts, password utilities, authentication/authorization flows, users, roles, privileges, and privilege evaluators. |
| Serialization | Zongsoft.Serialization |
Serializer contracts, JSON serializer helpers, serialization options, naming conventions, member attributes, and System.Text.Json converters. |
| Expressions and text | Zongsoft.Expressions, Zongsoft.Text |
Lexer/tokenizer infrastructure, expression evaluator contracts, syntax exceptions, regular-text processing, and template contracts. |
| Reflection | Zongsoft.Reflection |
High-performance reflection helpers and member-expression parsing/evaluation. |
| Runtime helpers | Zongsoft.Resources, Zongsoft.Scheduling, Zongsoft.Versioning, Zongsoft.Terminals |
Resource lookup, trigger abstractions, semantic version parsing, and terminal/console command execution. |
Repository Layout
Zongsoft.Core/
src/ Main library source code.
test/ xUnit tests for core behaviors.
samples/ Console samples for MemoryCache, Spooler, Superviser, and EventExchanger.
benchmark/ BenchmarkDotNet benchmarks for reflection and data model helpers.
Build and Test
dotnet restore Zongsoft.Core.slnx
dotnet build Zongsoft.Core.slnx -c Release
dotnet test test/Zongsoft.Core.Tests.csproj -c Release
The repository also includes a Cake script:
dotnet cake build.cake --target=test --edition=Release
Samples
The samples directory contains small console applications that exercise real APIs from this package:
| Sample | Focus |
|---|---|
samples/memorycache |
MemoryCache, expiration scanning, limit handling, and terminal output. |
samples/spooler |
Spooler<T> batching under high write volume. |
samples/superviser |
Superviser, Supervisable, worker state reporting, and terminal commands. |
samples/eventexchanger |
EventExchanger channels and application context integration. |
License
Zongsoft.Core is released under the LGPL-3.0-or-later license.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
-
net10.0
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Caching.Memory (>= 10.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.0)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection (>= 10.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.0)
- Microsoft.Extensions.ObjectPool (>= 10.0.0)
- Microsoft.Extensions.Options (>= 10.0.0)
- Microsoft.Extensions.Primitives (>= 10.0.0)
-
net8.0
- Microsoft.Extensions.Caching.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Caching.Memory (>= 8.0.1)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.FileExtensions (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.ObjectPool (>= 8.0.13)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Primitives (>= 8.0.0)
-
net9.0
- Microsoft.Extensions.Caching.Abstractions (>= 9.0.2)
- Microsoft.Extensions.Caching.Memory (>= 9.0.2)
- Microsoft.Extensions.Configuration (>= 9.0.2)
- Microsoft.Extensions.Configuration.FileExtensions (>= 9.0.2)
- Microsoft.Extensions.DependencyInjection (>= 9.0.2)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.2)
- Microsoft.Extensions.ObjectPool (>= 9.0.2)
- Microsoft.Extensions.Options (>= 9.0.2)
- Microsoft.Extensions.Primitives (>= 9.0.2)
NuGet packages (51)
Showing the top 5 NuGet packages that depend on Zongsoft.Core:
| Package | Downloads |
|---|---|
|
Zongsoft.Web
This is a base class library that provides web development. |
|
|
Zongsoft.Plugins
This is a framework about plugin application development. |
|
|
Zongsoft.Data
This is an Object/Relational Mapping(ORM) data engine. |
|
|
Zongsoft.Externals.Redis
This is a library about Redis SDK. |
|
|
Zongsoft.Security
This is a class library about security development. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 7.50.1 | 7 | 7/2/2026 |
| 7.50.0 | 185 | 6/17/2026 |
| 7.49.0 | 100 | 6/16/2026 |
| 7.48.0 | 125 | 6/6/2026 |
| 7.47.0 | 117 | 5/16/2026 |
| 7.46.0 | 234 | 5/3/2026 |
| 7.45.2 | 126 | 4/29/2026 |
| 7.45.1 | 116 | 4/27/2026 |
| 7.45.0 | 160 | 4/24/2026 |
| 7.44.0 | 110 | 4/21/2026 |
| 7.43.0 | 123 | 4/14/2026 |
| 7.42.0 | 151 | 4/10/2026 |
| 7.41.3 | 114 | 4/9/2026 |
| 7.41.2 | 128 | 4/7/2026 |
| 7.41.1 | 121 | 4/6/2026 |
| 7.41.0 | 249 | 4/5/2026 |
| 7.40.1 | 122 | 3/31/2026 |