CSharpDB.Primitives 2.7.0

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package CSharpDB.Primitives --version 2.7.0
                    


                    

                
NuGet\Install-Package CSharpDB.Primitives -Version 2.7.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="2.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CSharpDB.Primitives" Version="2.7.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 2.7.0
                    


                    

                
#r "nuget: CSharpDB.Primitives, 2.7.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@2.7.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=2.7.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=CSharpDB.Primitives&version=2.7.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
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 (8)

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

Package Downloads
CSharpDB.Sql

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

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

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

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

Read-only storage diagnostics toolkit for CSharpDB database and WAL files.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0 80 4/8/2026
2.9.1 88 4/7/2026
2.8.1 118 4/6/2026
2.8.0 117 4/4/2026
2.7.0 145 3/31/2026
2.6.0 141 3/29/2026
2.5.0 234 3/28/2026
2.4.0 142 3/24/2026
2.3.0 132 3/22/2026
2.2.0 124 3/21/2026
2.0.1 149 3/14/2026
2.0.0 130 3/13/2026
1.9.0 154 3/12/2026
1.8.0 158 3/11/2026
1.7.0 152 3/8/2026
1.6.0 146 3/8/2026
1.5.0 147 3/7/2026
1.4.0 148 3/7/2026
1.3.0 147 3/6/2026