CSharpDB.Primitives 3.9.0

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package CSharpDB.Primitives --version 3.9.0
                    
NuGet\Install-Package CSharpDB.Primitives -Version 3.9.0
                    
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="CSharpDB.Primitives" Version="3.9.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CSharpDB.Primitives" Version="3.9.0" />
                    
Directory.Packages.props
<PackageReference Include="CSharpDB.Primitives" />
                    
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 CSharpDB.Primitives --version 3.9.0
                    
#r "nuget: CSharpDB.Primitives, 3.9.0"
                    
#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 CSharpDB.Primitives@3.9.0
                    
#: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=CSharpDB.Primitives&version=3.9.0
                    
Install as a Cake Addin
#tool nuget:?package=CSharpDB.Primitives&version=3.9.0
                    
Install as a Cake Tool

CSharpDB.Primitives

Shared types, schema definitions, and error codes for the CSharpDB embedded database engine.

NuGet .NET 10 Release License: MIT

Overview

CSharpDB.Primitives is the low-level foundation package for CSharpDB. It defines the database type system, schema model, and error codes used by higher-level CSharpDB packages.

If you are building an application, prefer the top-level package:

dotnet add package CSharpDB

Key Types

Type Description
DbType Enum of supported database types: Null, Integer, Real, Text, Blob
DbValue Discriminated-union struct representing a single database value with comparison, equality, and truthiness semantics
TableSchema Table structure definition including columns, primary key, and qualified mappings for JOINs
ColumnDefinition Column metadata: name, type, nullability, primary key flag, and identity flag
IndexSchema Index metadata: name, table, columns, uniqueness
TriggerSchema Trigger metadata: name, table, timing, event, and body SQL
DbFunctionRegistry Host-registered trusted scalar functions for SQL and expression surfaces
DbCommandRegistry Host-registered trusted commands for Forms, Reports, and pipeline automation surfaces
DbCommandOptions Command description plus optional timeout and long-running metadata
CSharpDbException Typed exception with ErrorCode covering 15+ error conditions

Usage

using CSharpDB.Primitives;

// Create typed values
var id = DbValue.FromInteger(42);
var name = DbValue.FromText("Alice");
var balance = DbValue.FromReal(100.50);
var empty = DbValue.Null;

// Compare values
bool isPositive = DbValue.Compare(balance, DbValue.FromReal(0)) > 0;

// Define a schema
var schema = new TableSchema
{
    TableName = "users",
    Columns =
    [
        new ColumnDefinition { Name = "id", Type = DbType.Integer, IsPrimaryKey = true },
        new ColumnDefinition { Name = "name", Type = DbType.Text },
        new ColumnDefinition { Name = "email", Type = DbType.Text, Nullable = true }
    ]
};

Installation

dotnet add package CSharpDB.Primitives
Package Description
CSharpDB All-in-one package for application developers
CSharpDB.Engine Embedded database engine with SQL and NoSQL APIs
CSharpDB.Data ADO.NET provider
CSharpDB.Storage B+tree storage engine

License

MIT - see LICENSE for details.

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

    • No dependencies.

NuGet packages (10)

Showing the top 5 NuGet packages that depend on CSharpDB.Primitives:

Package Downloads
CSharpDB.Storage

B+tree storage engine with page cache, write-ahead log (WAL), crash recovery, and concurrent snapshot-isolated readers.

CSharpDB.Sql

SQL tokenizer, recursive-descent parser, and AST for the CSharpDB embedded database.

CSharpDB.Execution

Query planner, operator tree, and expression evaluator for the CSharpDB embedded database.

CSharpDB

All-in-one package for CSharpDB application development. Includes the unified client, engine, ADO.NET provider, and diagnostics.

CSharpDB.Engine

Lightweight embedded SQL database engine for .NET. Single-file storage, WAL durability, concurrent readers, and a typed Collection<T> NoSQL API.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.9.1 117 6/11/2026
3.9.0 195 5/31/2026
3.8.0 198 5/17/2026
3.7.0 213 5/9/2026
3.6.0 187 5/3/2026
3.5.0 171 4/28/2026
3.4.0 167 4/25/2026
3.3.0 159 4/23/2026
3.2.0 173 4/19/2026
3.1.2 165 4/15/2026
3.1.0 165 4/15/2026
3.0.0 177 4/8/2026
2.9.1 160 4/7/2026
2.8.1 165 4/6/2026
2.8.0 166 4/4/2026
2.7.0 169 3/31/2026
2.6.0 166 3/29/2026
2.5.0 257 3/28/2026
2.4.0 165 3/24/2026
2.3.0 155 3/22/2026
Loading failed