DCoding.Xml.XQueryX 1.0.1

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

DCoding.Xml.XQueryX

V1.0 technical selection: Community, Professional. Declared assets/hosts: net8.0, net11.0. See the current edition and API/runtime catalog for mode and host limits. Selection and retained development results do not replace final artifact qualification, the supplied license or human release approval.

This optional .NET 8 package provides the public XQueryX conversion and compilation boundary over DCoding.Xml.XQuery. Core XML packages do not depend on this package, and its public API does not expose the internal XQuery AST.

Set XQueryXProcessingOptions.Version to XQueryX10, XQueryX30, or XQueryX31 to select the normative XML grammar for conversion or compilation. The default remains XQueryX 3.1. This setting is independent of CompileOptions.LanguageVersion, which selects XQuery semantics. Both the XML grammar and any declared XQuery version must be compatible with the selected XQueryX profile.

XQueryXProcessor.Convert accepts XQuery text or a successful XQueryParseResult. XQueryXProcessor.Compile accepts caller-owned XmlReader and Stream instances as well as XmlDocument and XDocument inputs. Operations return structured result diagnostics for ordinary query, XML, resource-limit, and unsupported-codec failures. Argument misuse, disposed objects, I/O failures, and cancellation retain their normal .NET exceptions.

Inputs are processed synchronously under explicit finite XQueryXResourceLimits. Streams created by the package use an XML reader with DTD processing prohibited and no resolver. Caller-owned readers and streams remain open, and in-memory XML inputs are never retained.

The M28 shared-AST codec routes decoded modules through the same semantic analysis and canonical Compiler IR as text XQuery. Supported XQuery 3.1 operation families round-trip through XQueryX without a second parser or evaluator. Forbidden extension markup fails with DCXML1004. The package has no ambient file access and no network access.

The package contains net8.0 and net11.0 assemblies and English XML API documentation. Portable symbols are supplied in the matching .snupkg. See LICENSE.md and NOTICE.md for the W3C XQueryX schema notices and the current legal and private-publication boundary.

Full Text XML uses the exact http://www.w3.org/2007/xpath-full-text namespace and is enabled through CompileOptions.FullText. Select FullText10 with XQuery/XQueryX 1.0, FullText30 with 3.0, or the explicitly labelled FullText30Integration31 with the 3.1 host. The default is disabled. Conversion retains logical selections, position filters, match options, prolog defaults, score bindings and unevaluated weight expressions. XML compilation uses the shared typed AST and compiler IR, including scoped expression children and source identities.

The Full Text XML schema represents extension option names as QNames. To convert a URI-qualified option, supply an existing, unshadowed prefix binding in the original module or CompileOptions.StaticContext. Conversion reuses that binding and never introduces namespace declarations, which could change xs:QName behavior. A URI that cannot be represented faithfully returns DCXML1001. Use the same namespace context when compiling the XML document. The shared compiler rules determine predefined and explicitly declared prefix precedence.

Both official Full Text schemas and their option schemas are embedded without modification. Imports and includes bind only to the selected embedded XQueryX schema and matching embedded option schema; schema hints do not resolve files or URLs. Full Text 1.0's literal thesaurus levels and 3.0's expression wrappers retain unbounded integer values. Incompatible profiles, malformed selections, unexpected empty-marker data and hostile XML produce structured diagnostics.

This codec provides syntax and typed-plan transport. Full Text matching, numeric scoring and weight evaluation, and capable persisted-plan replay remain separate runtime obligations. Score XML compilation retains the core compiler's current scoring diagnostic until that runtime implementation is available; conversion never drops score metadata or supplies constant scores.

Update 1.0 XML uses http://www.w3.org/2007/xquery-update-10. Enable it explicitly with CompileOptions.UpdateProfile = XQueryUpdateProfile.Update10, select XQueryX10, and use the XQuery 1.0 language profile. Other XQueryX versions do not enable draft Update 3.0. The codec embeds the official Update schema and redefined base schema, resolves their dependencies only from embedded bytes, and preserves revalidation, updating functions, insert positions, delete, replace, rename, and copy/modify/return expressions.

XQueryXCompileResult.CanonicalQueryText exposes successfully decoded module text. Check Success before executing a compiled query. Library modules also provide canonical text when the ordinary compiler rejects standalone library execution; import that text through an explicit IXQueryModuleResolver. Decoded external updating functions require current caller-owned callback authority. XML conversion and saved plans do not grant execution authority.

Use DCoding.Xml.XQuery.Update to collect pending updates and commit them explicitly to a caller-owned target. See samples/m36-update-xqueryx for an isolated package consumer, fresh and persisted execution, and separate-process replay. Update and Full Text family qualification and private release gates remain separate from this codec and its focused examples.

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

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1 45 11/20/2026

Stable 1.0.1: licensing and packaging correction delivery. Public APIs and edition rights are unchanged.