PhoenixmlDb.XQuery
1.6.12
dotnet add package PhoenixmlDb.XQuery --version 1.6.12
NuGet\Install-Package PhoenixmlDb.XQuery -Version 1.6.12
<PackageReference Include="PhoenixmlDb.XQuery" Version="1.6.12" />
<PackageVersion Include="PhoenixmlDb.XQuery" Version="1.6.12" />
<PackageReference Include="PhoenixmlDb.XQuery" />
paket add PhoenixmlDb.XQuery --version 1.6.12
#r "nuget: PhoenixmlDb.XQuery, 1.6.12"
#:package PhoenixmlDb.XQuery@1.6.12
#addin nuget:?package=PhoenixmlDb.XQuery&version=1.6.12
#tool nuget:?package=PhoenixmlDb.XQuery&version=1.6.12
PhoenixmlDb.XQuery
XQuery 4.0 query engine for PhoenixmlDb — query XML and JSON documents with the full power of XQuery.
Features
- Full XQuery 4.0 — FLWOR expressions, constructors, modules, user-defined functions
- XPath 4.0 — complete XPath implementation with 240+ built-in functions
- JSON support —
json-doc(),parse-json(), maps, arrays — query JSON natively - Full-text search —
ft:contains()with stemming, wildcards, proximity, scoring - Update Facility — insert, delete, replace, rename, transform expressions
- Type system — records, enums, union types (XQuery 4.0)
Quick example
using PhoenixmlDb.XQuery.Execution;
var engine = new QueryEngine();
// Simple query
var results = engine.ExecuteToListAsync(
"for $x in 1 to 10 where $x mod 2 = 0 return $x * $x");
// Query XML documents
var books = engine.ExecuteAsync(
"//book[price > 30]/title",
containerId);
Related packages
| Package | Description |
|---|---|
| PhoenixmlDb.Core | Core types and XDM data model (dependency) |
| PhoenixmlDb.Xslt | XSLT 4.0 transformation engine |
| PhoenixmlDb.XQuery.Cli | xquery command-line tool |
Documentation
Full documentation at phoenixml.dev
License
Apache 2.0
| 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 was computed. 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
- Antlr4.Runtime.Standard (>= 4.13.1)
- Lucene.Net (>= 4.8.0-beta00016)
- Lucene.Net.Analysis.Common (>= 4.8.0-beta00016)
- PhoenixmlDb.Core (>= 1.6.7)
-
net8.0
- Antlr4.Runtime.Standard (>= 4.13.1)
- Lucene.Net (>= 4.8.0-beta00016)
- Lucene.Net.Analysis.Common (>= 4.8.0-beta00016)
- PhoenixmlDb.Core (>= 1.6.7)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on PhoenixmlDb.XQuery:
| Package | Downloads |
|---|---|
|
PhoenixmlDb.Xslt
XSLT 4.0 transformation engine for PhoenixmlDb |
|
|
Phoenixml.Platform.Editor.Xml
XML/XSD vocabulary binding for Phoenixml.Platform — concrete IDocument and ITreeNodeProvider implementations against PhoenixmlDb.Core's XDM, XSD schema validation pipeline. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.6.12 | 0 | 9/1/2026 |
| 1.6.11 | 92 | 8/29/2026 |
| 1.6.10 | 103 | 8/29/2026 |
| 1.6.9 | 121 | 8/27/2026 |
| 1.6.8 | 113 | 8/26/2026 |
| 1.6.7 | 148 | 8/24/2026 |
| 1.6.6 | 140 | 8/23/2026 |
| 1.6.5 | 134 | 8/21/2026 |
| 1.6.2 | 173 | 8/16/2026 |
| 1.6.1 | 186 | 7/31/2026 |
| 1.6.0 | 161 | 7/27/2026 |
| 1.5.5 | 188 | 7/12/2026 |
| 1.5.4 | 189 | 7/9/2026 |
| 1.5.3 | 136 | 7/8/2026 |
| 1.5.2 | 137 | 7/7/2026 |
| 1.5.1 | 154 | 6/30/2026 |
| 1.5.0 | 114 | 6/28/2026 |
| 1.4.7 | 147 | 6/25/2026 |
| 1.4.6 | 222 | 6/17/2026 |
| 1.4.5 | 146 | 6/17/2026 |
Six fixes, four of them found by running XSpec's 284-suite corpus against the engine. Two are
the reason this release exists: without them the XSLT engine cannot report XSpec results
correctly.
### `namespace-node()` matched every node kind
`ItemType` had no `Namespace` member, so the parser mapped `namespace-node()` to `ItemType.Node`
— the test that matches ANY node. `$x instance of namespace-node()` therefore answered true for
elements, attributes, text, comments and documents alike.
XSpec decides whether a result can be wrapped in a document node with:
$item instance of node()
and not($item instance of attribute() or $item instance of namespace-node())
With the second test always true, that predicate was always false. No result was ever wrapped,
so the context item for every `x:expect` predicate stayed a parentless element rather than a
document node. An assertion written as `//foo`, the idiomatic XSpec style, could never match,
and one written as `/foo` raised XPDY0050.
Measured against the XSpec corpus: 4 more suites run to completion, 64 more assertions pass.
### `xs:integer()` crashed on a value wider than `long`
`BigInteger` does not implement `IConvertible`, and the constructor's fallback called
`Convert.ToInt64`. The catch clauses covered `FormatException` and `OverflowException` but not
`InvalidCastException`, so a CLR message reached the user:
Unable to cast object of type 'System.Numerics.BigInteger' to type 'System.IConvertible'
The value came from `xs:unsignedLong`, which returns a `BigInteger` above `long.MaxValue` by
design — a producer and a type matcher that already agreed, with the constructor between them
disagreeing.
### `xs:integer` is unbounded
`xs:integer` has no upper bound in XSD, but the constructor capped it at `long` and reported
`FORG0001 ... value out of range` for values the type permits. `MatchesItemType` already
accepted a `BigInteger` for `ItemType.Integer`, so widening the constructor aligns it with the
rest of the engine rather than adding a representation. Literals wider than `long` now parse.
### `fn:trace` rendered the container, not the value
`fn:trace` interpolated its argument, so `ToString()` on a container answered with the CLR type
— `System.Object[]` rather than the sequence. A diagnostic that hides the value defeats its own
purpose. Adds `XdmShape.Render`.
### `except`, `union` and `intersect` did not say what the bad operand was
An operand of the except operator is not a node
That message repeats the error code and omits both facts a user needs: WHICH of the two operands,
and what it actually held. It is emitted from two separate throw sites, so it could not even
distinguish left from right. It now reads:
The left operand of the except operator is not a node: the string ''
Found while tracing an XSpec failure through four wrong hypotheses; the improved message
identified the value on the first run afterwards.
### The CLI aborted on a spec-defined error
`XQueryException`, the family raised by built-in functions, had no catch arm and fell to a
catch-all whose `throw` aborted the process. `xquery "xs:integer('nope')"` exited 134 with a
stack dump. It now reports `Runtime error [FORG0001]` and exits 3.
XQuery.Tests 1524 passed, 0 failed
XQuery.Cli.Tests 8 passed, 0 failed