Zongsoft.Core 7.50.1

dotnet add package Zongsoft.Core --version 7.50.1
                    
NuGet\Install-Package Zongsoft.Core -Version 7.50.1
                    
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="Zongsoft.Core" Version="7.50.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Zongsoft.Core" Version="7.50.1" />
                    
Directory.Packages.props
<PackageReference Include="Zongsoft.Core" />
                    
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 Zongsoft.Core --version 7.50.1
                    
#r "nuget: Zongsoft.Core, 7.50.1"
                    
#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 Zongsoft.Core@7.50.1
                    
#: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=Zongsoft.Core&version=7.50.1
                    
Install as a Cake Addin
#tool nuget:?package=Zongsoft.Core&version=7.50.1
                    
Install as a Cake Tool

Zongsoft Core

License NuGet Version NuGet Downloads GitHub Stars

English | 简体中文


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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed