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
<PackageReference Include="DCoding.Xml.XQueryX" Version="1.0.1" />
<PackageVersion Include="DCoding.Xml.XQueryX" Version="1.0.1" />
<PackageReference Include="DCoding.Xml.XQueryX" />
paket add DCoding.Xml.XQueryX --version 1.0.1
#r "nuget: DCoding.Xml.XQueryX, 1.0.1"
#:package DCoding.Xml.XQueryX@1.0.1
#addin nuget:?package=DCoding.Xml.XQueryX&version=1.0.1
#tool nuget:?package=DCoding.Xml.XQueryX&version=1.0.1
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 | 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 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. |
-
net11.0
- DCoding.Xml.XQuery (>= 1.0.1)
-
net8.0
- DCoding.Xml.XQuery (>= 1.0.1)
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.