PhoenixmlDb.XQuery 2.8.0

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

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

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
2.8.0 90 10/9/2026
2.7.0 106 10/7/2026
2.6.0 139 10/6/2026
2.5.1 360 10/1/2026
2.5.0 94 10/1/2026
2.4.1 406 9/28/2026
2.4.0 139 9/28/2026
2.3.0 127 9/28/2026
2.2.0 191 9/24/2026
2.1.0 335 9/17/2026
2.0.0 358 9/15/2026
1.8.0 302 9/14/2026
1.7.0 687 9/11/2026
1.6.15 208 9/9/2026
1.6.14 196 9/7/2026
1.6.13 161 9/4/2026
1.6.12 184 9/1/2026
1.6.11 156 8/29/2026
1.6.10 182 8/29/2026
1.6.9 263 8/27/2026
Loading failed

The shared schema layer and schema caching; resource-policy security fixes. QT3: 251 failing of
31,331 (2.7.0: 257). Requires PhoenixmlDb.Core 2.4.0.

### Security: resource policy bypasses and host information disclosure with untrusted queries (GHSA-g2xr-r7jg-2v33)

Only hosts that evaluate queries from untrusted parties under a `ResourcePolicy` are affected.
Every HTTP redirect is now authorized against the policy, documents included with XInclude are
read under the policy of the including document, a refusal names only the location as the query
wrote it, and a relative base URI declaration is not resolved against the working directory under
a policy. See [GHSA-g2xr-r7jg-2v33](https://github.com/phoenixmldb/phoenixmldb-xquery/security/advisories/GHSA-g2xr-r7jg-2v33)
for the details and workarounds.

### Schemas

- **`XsdSchemaProvider` reads schemas through the shared schema layer** (PhoenixmlDb.Core). Changed
 behaviour to check on upgrade:
 - an `xs:include`, `xs:import` or `xs:redefine` that cannot be read fails the load (`XQST0059`);
   it used to be skipped;
 - a schema document with a DOCTYPE is refused;
 - schema text with no base URI does not resolve a relative `schemaLocation` against the current
   directory; use `AddFromString(namespace, text, baseUri)`;
 - a schema that requires XSD 1.1 says so, naming the document and the constructs (#217).
- **Schemas imported by `import schema` are compiled once and shared**
 (`XsdSchemaProvider.ImportCache`). Providers that import the same files share one compiled
 schema set, and a changed schema file or included file is seen by the next query. A query
 importing a 705 KB schema: 39.7 ms before, 1.6 ms now.
- **An atomic value keeps its schema-defined type**: a value from a cast, a constructor function
 or a validated node. `t:size('8') instance of t:size` is true.

### Other changes

- A cancelled query does not start a regex or pattern-facet match (#205).
- The `xquery4` CLI writes `xmlns=""` for an element in no namespace inside a default namespace
 (#105); it ships on `cli-v2.8.0`.

### API

- New: `JsonXmlConverter` (`ToXml`, `ToXmlText`) with `JsonToXmlOptions`; `XsdSchemaProvider(CompiledSchema)`,
 `XsdSchemaProvider.Catalog`, `XsdSchemaProvider.ImportCache`; `ISchemaProvider.AddSchemaText` and
 `ISchemaProvider.IsSchemaSimpleTypeDerivedFrom` (default implementations; custom providers
 compile unchanged); `XQueryParserFacade.Parse(string, Func<string, string?>)`.