MVPXML Wiki & Documentation Rss Feed

New Comment on "xinclude.net"

JanieGraham — Mon, 19 Sep 2011 15:55:48 GMT

Hey thanks for all the information pertaining to xsl fo editors. I have been trying to a lot of research on the subject and I'm starting to learn more about how to use these types of editors. One site that I particularly enjoyed was http://www.ecrion.com

New Comment on "xinclude.net"

JanieGraham — Mon, 19 Sep 2011 15:55:26 GMT

Hey thanks for all the information pertaining to <a href="http://www.ecrion.com/products/xfdesigner/overview.aspx">xsl fo editors</a>. I have been trying to a lot of research on the subject and I'm starting to learn more about how to use these types of editors.

New Comment on "Common"

schavez70 — Mon, 03 Jan 2011 17:06:41 GMT

looking for help with IndexingXPathNavigator. I have a large XML Document with Structure simular to <OptGroup_SMDETSEMIANNUAL> <SMDETSEMIANNUAL> <_Location_>East Hall</_Location_> <_Area_>Floor 03</_Area_> <_Item_>Smoke Detector - SemiAnnual</_Item_> <_SerialNr_> </_SerialNr_> <_AssetNr_>-</_AssetNr_> <_Mfr_>WALTER KIDDE</_Mfr_> <_ModelNr_> </_ModelNr_> <Sens>Pass</Sens> <Sens_Answer2>----</Sens_Answer2> <Sens_datetime_/> <Visual>Pass</Visual> <Visual_Answer2>----</Visual_Answer2> <Visual_datetime_/> <FunctSmoke>Pass</FunctSmoke> <FunctSmoke_Answer2>----</FunctSmoke_Answer2> <_FunctSmoke_datetime_>12/5/2010 10:53:07 AM</_FunctSmoke_datetime_> </SMDETSEMIANNUAL> </OptGroup_SMDETSEMIANNUAL> <OptGroup_PHONESETSEMIANNUAL> <PHONESETSEMIANNUAL> <_Location_>Western end</_Location_> <_Area_>Basement</_Area_> <_Item_>Phone Set - SemiAnnual</_Item_> <_SerialNr_> </_SerialNr_> <_AssetNr_>-</_AssetNr_> <_Mfr_>ANGUS FIRE ARMOUR</_Mfr_> <_ModelNr_> </_ModelNr_> <Visual>Pass</Visual> <Visual_Answer2>----</Visual_Answer2> <Visual_datetime_/> <FunctEVAC>Pass</FunctEVAC> <FunctEVAC_Answer2>----</FunctEVAC_Answer2> <_FunctEVAC_datetime_>12/2/2010 11:43:30 AM</_FunctEVAC_datetime_> </PHONESETSEMIANNUAL> </OptGroup_PHONESETSEMIANNUAL> I have tried to index it using IndexedXpathNavigator.AddKey However it only seems to be able to return one node set that matches the "use" key... What I need it to do is returen ALL nodes that just match the Key. For example if I assign the following keys: IndexedXpathNavigator.AddKey("GroupKey"," //OptGroup_PHONESETSEMIANNUAL//PHONESETSEMIANNUAL", "PHONESETSEMIANNUAL"); IndexedXpathNavigator.AddKey("GroupKey"," //OptGroup_SMDETSEMIANNUAL//SMDETSEMIANNUAL", "SMDETSEMIANNUAL"); I would like a way to to return All nodes for the key "GroupKey".... However when I run IndexedXpathNavigator.Select("key(GroupKey,value)") it returns nothing because it is requiring a value... This value is dynamic and can be different for the entire group... Any suggestions or help would be greatly appreciated!!! Sincerely Ernie

UPDATED WIKI: Home

dcazzulino — Wed, 12 Sep 2007 20:53:41 GMT

Mvp.Xml project is developed by Microsoft MVPs in XML technologies and XML Web Services worldwide. It is aimed at supplementing .NET framework XML processing functionality available through the System.Xml namespace and related namespaces such as System.Web.Services. It is documented extensively through weblog posts. All the project's classes contain extensive tests to ensure its quality, as well as the peer review among this highly focused group of XML lovers.

Mvp.Xml project currently provides .NET implementations of the EXSLT, XML Base, XInclude, XPointer as well as a unique set of utility classes and tools making XML programming in .NET platform easier, more productive and effective.

Mvp.Xml project supplements .NET functionality, but as .NET platform evolves some parts of the Mvp.Xml library become redundant. Beware that we will be dropping support for anything that becomes supported natively in .NET.

Mvp.Xml project provides the following tools:

Mvp.Xml Library (latest release):

XPathmania (latest release)
SSE: Simple Sharing Extensions for .NET
Helix: RDF for .NET

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: Home

dcazzulino — Thu, 16 Aug 2007 14:20:51 GMT

Mvp.Xml Library (latest release):

XPathmania (latest release)
SSE: Simple Sharing Extensions for .NET

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: Home

dcazzulino — Thu, 16 Aug 2007 14:20:30 GMT

Mvp.Xml Library (latest release):

XPathmania (latest release)
*SSE: Simple Sharing Extensions for .NET

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: Home

dcazzulino — Thu, 16 Aug 2007 14:19:46 GMT

Mvp.Xml Library (latest release):

XPathmania (latest release)

Simple Sharing Extensions for .NET

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: XPointer.NET

olegt — Tue, 03 Jul 2007 05:57:53 GMT

Mvp.Xml Library: XPointer.NET module

The XPointer.NET module provides an implementation of the XPointer Framework Recommendation written in C# for the .NET platform. XPointer.NET supports XPointer element() Scheme, XPointer xmlns() Scheme, XPointer xpath1() Scheme and XPointer xpointer() Scheme (XPath subset only). XPointer.NET was designed and implemented for the XInclude.NET module, but it can be used on its own.

For more info about XPointer see References.

1. Usage

XPointerReader class, found in the Mvp.Xml.XPointer namespace, is the key class. It's customized XmlReader, which implements XPointer Framework, XPointer element() Scheme, XPointer xmlns() Scheme, The XPointer xpath1() Scheme and XPointer xpointer() Scheme (XPath subset only) in a caching forward-only fashion.

Usage samples:

1. Basic identifying of subresources using XPointer:

XPointerReader r =
    new XPointerReader("books.xml", "xpointer(//book)");          
while (r.Read())
    Console.WriteLine(r.ReadOuterXml());
r.Close();

2. Running XPointerReader on an in-memory XML store:

XPathDocument doc = new XPathDocument("books.xml");
XPointerReader r =
    new XPointerReader(doc, "xpointer(//book)");          
while (r.Read())
    Console.WriteLine(r.ReadOuterXml());
r.Close();

XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XPointerReader r =
    new XPointerReader(doc, "xpointer(//book)");          
while (r.Read())
    Console.WriteLine(r.ReadOuterXml());
r.Close();

3. When running XPointerReader on XPathDocument or XmlDocument, you can get underlying XPathNavigator via IHasXPathNavigator interface:

XPathNavigator nav = ((IHasXPathNavigator)reader).GetNavigator();

4. Namespace-aware XPointers:

XPointerReader r =
    new XPointerReader("books.xml", "xmlns(bk=http://books.com)xpointer(//bk:book)");

5. Fallback-like XPointers. Recall that XPointer can consist of a several pointer parts, which are evaluated in turn until one identifies any subresource. That property can be used to create more reliable XPointers:

XPointerReader r =
    new XPointerReader("books.xml", "element(bk101)xpointer(//book[@id='bk101'])");

2. Conformance

Only XPath subset of the XPointer xpointer() Scheme is currently supported.

3. Support

You can get support using the following options:

XInclude.NET Forum at the XML Lab
Mvp.Xml User Forum
Please feel free to report any bugs or suggest features via the Issue Tracker.

4. References

"Combining XML Documents with XInclude" by Oleg Tkachenko, MSDN
XPointer Framework Recommendation
XPointer element() Scheme
XPointer xmlns() Scheme
XPointer xpointer() Scheme
nxslt.exe - XInclude/XPointer enabled command line XSLT utility
eXml - XInclude/XPointer enabled XML ASP.NET Web Server control

UPDATED WIKI: Home

olegt — Tue, 03 Jul 2007 05:43:47 GMT

Mvp.Xml Library (latest release):

XPathmania (latest release)

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: Common

olegt — Tue, 03 Jul 2007 05:39:59 GMT

Mvp.Xml Library: Common module

The Common module includes a set of commonly useful classes in the Mvp.Xml.Common, Mvp.Xml.Common.Serialization, Mvp.Xml.Common.XPath and Mvp.Xml.Common.Xsl namespaces, which extend the .NET functionality available through the System.Xml and related namespaces.

The full Common module API documentation can found at http://www.xmllab.net/mvpxml.

The following is a list of key features in no particular order, a short explanation and a link to its corresponding full explanation:

Mvp.Xml.Common namespace:

New! XmlWrappingReader - base XmlReader that can be used to easily create new readers by wrapping existing ones. See On creating custom XmlReaders/XmlWriters in .NET 2.0
New! XmlWrappingWriter - base XmlWriter that can be used to easily create new writers by wrapping existing ones. See On creating custom XmlReaders/XmlWriters in .NET 2.0
XmlBaseAwareXmlReader: XmlReader supporting W3C XML Base 1.0
XhtmlWriter: XmlWriter conforming to the HTML compatibility guidelines defined in the XHTML 1.0 specification
XmlFirstUpperReader/XmlFirstLowerWriter - for streaming transforming PascalCase XML documents into camelCase ones
XmlFragmentReader - XmlReader which was created to read fragments (using Fragment for its XmlReaderSettings) with a "virtual" root node so that it can be loaded into an XmlDocument or XPathDocument
XmlNodeFactory - creates XmlNode wrapper instances for different XML APIs, for use in XML serialization. See: High-performance XML (III): returning well-formed XML from WebServices without XmlDocument
XmlNodeListFactory - constructs XmlNodeList instances from XPathNodeIterator objects. See How to get an XmlNodeList from an XPathNodeIterator
XmlNormalizingReader - XmlReader that only exposes xmlns attribute declarations if they have not been previously declared by a parent element, normalizing the output XML so that no duplicate namespace declarations exist

Mvp.Xml.Common.XPath namespace:

DynamicContext - provides the evaluation context for fast execution and custom variables resolution. See High-performance XML (I): Dynamic XPath expressions compilation and Mitigating XPath Injection Attacks in .NET
New! EmptyXPathNodeIterator - empty XPathNodeIterator, used to represent empty node sequence. Can be used to return empty nodeset out of an XSLT or XPath extension function
IndexingXPathNavigator - IndexingXPathNavigator enables lazy or eager indexing of any XML store (XmlDocument, XPathDocument or any other IXPathNavigable XML store) thus providing an alternative way to select nodes using XSLT key() function directly from an index table instead of searhing the XML tree. This allows drastically decrease selection time on preindexed selections. See XML Indexing Part 1: XML IDs, XSLT Keys and IndexingXPathNavigator
New! SingletonXPathNodeIterator - XPathNodeIterator over a single node. Can be used to return a single node out of an XSLT or XPath extension function
SubtreeXPathNavigator - allows to navigate a subtree of an IXPathNavigable source, by limiting the scope of the navigator to that received at construction time. See High-performance XML (IV): subtree transformations without re-parsing
XPathCache - implements a cache of compiled XPath queries, for faster execution. See High-performance XML (II'): Enhance XPath execution performance with XPathCache
New! XPathDocumentWriter - XmlWriter that can produce an XPathDocument without the need to parse XML. Important: this class requires unrestricted member access reflection permissions in order to run. When using for chained XSLT transformations, a security-friendly alternative is to use XslReader.
XPathIteratorReader - provides an XmlReader over an XPathNodeIterator
XPathNavigatorIterator - an XPathNodeIterator that allows arbitrary addition of the XPathNavigator nodes that belong to the set

Mvp.Xml.Common.Xsl namespace:

New CharacterMappingXmlWriter - an XmlWriter implementation able to substitute characters appearing in text or attribute nodes. For character mapping semantics see XSLT 2.0.
MvpXslTransform - extends capabilities of the XslCompiledTransform class by adding support for transforming into XmlReader, built-in vast collection of EXSLT extention functions, multiple outputs, XHTML output mode, XSLT 2.0 character maps and transforming of IXPathNavigable along with XmlResolver. Also MvpXslTransform class provides new improved XSL transformation API by introducing concepts of IXmlTransform interface, XmlInput and XmlOutput. See HOW TO: Pipeline XSLT Transformations in .NET 2.0 Applications
XslReader - provides an efficient way to read results of an XSLT transformation via an XmlReader API. Due to architectural and performance reasons the XslCompiledTransform class doesn't support transforming to an XmlReader as obsolete XslTransform class did and XslReader's goal is to supplement such functionality. See HOW TO: Pipeline XSLT Transformations in .NET 2.0 Applications

Mvp.Xml.Common.Serialization namespace:

XmlSerializerCache - allows to work around the (assembly leak problem in the XmlSerializer). The cache will inspect if it contains any previously cached instances that are compatible with the parameters passed to the various overloads to the GetSerializer method before constructing a new XmlSerializer instance. It canonicalizes the parameter list to minimize the number of serializer objects in the cache

UPDATED WIKI: Common

olegt — Mon, 02 Jul 2007 11:53:55 GMT

Mvp.Xml Library: Common module

Mvp.Xml.Common namespace:

XmlBaseAwareXmlReader: XmlReader supporting W3C XML Base 1.0
XhtmlWriter: XmlWriter conforming to the HTML compatibility guidelines defined in the XHTML 1.0 specification.

*tbd...

UPDATED WIKI: XInclude.NET

olegt — Mon, 02 Jul 2007 11:44:55 GMT

Mvp.Xml Library: XInclude.NET module

The XInclude.NET module provides an implementation of the W3C XML Inclusions (XInclude)1.0 Recommendation and XPointer Framework Recommendation written in C# for the .NET platform. XInclude.NET supports XPointer element() Scheme, XPointer xmlns() Scheme, XPointer xpath1() Scheme and XPointer xpointer() Scheme (XPath subset only). XInclude.NET currently supports streamable subset of the XInclude, implemented as fast, non-caching, forward-only XIncludingReader class found in the Mvp.Xml.XInclude namespace.
For more info about XInclude, XPointer and XInclude.NET see References.

XInclude.NET has been thoroughly tested against XML Inclusions (XInclude) Version 1.0, W3C Conformance Test Suite (2004-11-03) under Microsoft .NET 1.0, 1.1 and 2.0 on Windows 2000, Windows XP and Windows Server 2003.

1. Usage

XmlReader reader = new XIncludingReader("source.xml");
while (reader.Read())
...

XML inclusion while building XmlDocument:

{{XmlReader reader = new XIncludingReader(XmlReader.Create("source.xml")); XmlDocument doc = new XmlDocument(); doc.Load(reader); ... }} XML inclusion before an XSL Transformation:

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("stylesheet.xsl");
XmlReader reader = new XIncludingReader("source.xml");
XPathDocument xdoc = new XPathDocument(reader);
xslt.Transform(xdoc, null, new StreamWriter("result.xml"));
...

Find more examples and test cases in the "test" directory of the sources. Note: When using XInclude with XSLT, take a look at the nxslt.exe - feature-rich .NET XSLT command line utility, which supports XInclude via the XInclude.NET module.

2. Custom XmlResolver

XIncludingReader supports custom URI resolving. This way one can include XML documents from a variety of sources, such as RDBMS or even generated on-the-fly. Find a sample of inlcuding XML data from SQL Server on Oleg Tkachenko's blog. Just set your XmlResolver object to the XmlResolver property of the XIncludingReader. XIncludingReader will call ResolveUri() and GetEntity() methods of your resolver when fetching a resource by URI referenced in "href" attribute of an xi:include element. A custom XmlResolver must return either System.IO.Stream or System.IO.TextReader or System.Xml.XmlReader from the GetEntity() method.

3. XPointer

XInclude.NET uses XPointer.NET module, which implements XPointer Framework, XPointer element() Scheme, XPointer xmlns() Scheme, XPointer xpath1() Scheme and XPointer xpointer() Scheme (XPath subset only). XPointerReader class, found in the Mvp.Xml.XPointer namespace represents XPointer-aware XmlReader and can be used as such outside of XInclude context too. Find more info at the XPointer.NET module homepage.

4. Conformance

XIncludingReader class implements the streamable subset of the XInclude - intra-document references are not supported. That means XIncludingReader treats an absence of an "href" attribute on an xi:include element as an XInclude resource error.
Syntactically incorrect URI references are treated as an XInclude resource error.
Only XPath subset of the xpointer() XPointer Scheme is supported.

5. Support

You can get support using the following options:

XInclude.NET Forum at the XML Lab
Mvp.Xml User Forum
Please feel free to report any bugs or suggest features via the Issue Tracker.

6. References

"Combining XML Documents with XInclude" by Oleg Tkachenko, MSDN
W3C XML Inclusions (XInclude)1.0
XPointer Framework Recommendation
XPointer element() Scheme
XPointer xmlns() Scheme
XPointer xpointer() Scheme
nxslt.exe - XInclude enabled command line XSLT utility.
eXml - XInclude enabled XML ASP.NET Web Server control.

UPDATED WIKI: XInclude.NET

olegt — Mon, 02 Jul 2007 11:41:45 GMT

Mvp.Xml Library: XInclude.NET module

1. Usage

XmlReader reader = new XIncludingReader("source.xml");
while (reader.Read())
...

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("stylesheet.xsl");
XmlReader reader = new XIncludingReader("source.xml");
XPathDocument xdoc = new XPathDocument(reader);
xslt.Transform(xdoc, null, new StreamWriter("result.xml"));
...

2. Custom XmlResolver

3. XPointer

4. Conformance

XIncludingReader class implements the streamable subset of the XInclude - intra-document references are not supported. That means XIncludingReader treats an absence of an "href" attribute on an xi:include element as an XInclude resource error.
Syntactically incorrect URI references are treated as an XInclude resource error.
Only XPath subset of the xpointer() XPointer Scheme is supported.

5. Support

You can get support using the following options:

XInclude.NET Forum at the XML Lab
Mvp.Xml User Forum
Please feel free to report any bugs or suggest features via the Issue Tracker.

6. References

"Combining XML Documents with XInclude" by Oleg Tkachenko, MSDN
W3C XML Inclusions (XInclude)1.0
XPointer Framework Recommendation
XPointer element() Scheme
XPointer xmlns() Scheme
XPointer xpointer() Scheme
nxslt.exe - XInclude enabled command line XSLT utility.
eXml - XInclude enabled XML ASP.NET Web Server control.

UPDATED WIKI: XInclude.NET

olegt — Mon, 02 Jul 2007 11:40:57 GMT

Mvp.Xml Library: XInclude.NET module

1. Usage

XIncludingReader class, found in the Mvp.Xml.XInclude namespace, is the key class. It's customized XmlReader, which implements streamable subset of the XInclude and XPointer in a fast, non-caching, forward-only fashion. It can be set on top of another XmlReader - such design allows to perform XML Inclusions in many different scenarios, e.g. before or after validation, before or after transforming XML etc. Here are some common usage scenarios:

XML inclusion during XML reading:

{{XmlReader reader = new XIncludingReader("source.xml"); while (reader.Read()) ... }} XML inclusion while building XmlDocument: {{XmlReader reader = new XIncludingReader(XmlReader.Create("source.xml")); XmlDocument doc = new XmlDocument(); doc.Load(reader); ... }} XML inclusion before an XSL Transformation:

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("stylesheet.xsl");
XmlReader reader = new XIncludingReader("source.xml");
XPathDocument xdoc = new XPathDocument(reader);
xslt.Transform(xdoc, null, new StreamWriter("result.xml"));
...

2. Custom XmlResolver

3. XPointer

4. Conformance

XIncludingReader class implements the streamable subset of the XInclude - intra-document references are not supported. That means XIncludingReader treats an absence of an "href" attribute on an xi:include element as an XInclude resource error.
Syntactically incorrect URI references are treated as an XInclude resource error.
Only XPath subset of the xpointer() XPointer Scheme is supported.

5. Support

You can get support using the following options:

XInclude.NET Forum at the XML Lab
Mvp.Xml User Forum
Please feel free to report any bugs or suggest features via the Issue Tracker.

6. References

"Combining XML Documents with XInclude" by Oleg Tkachenko, MSDN
W3C XML Inclusions (XInclude)1.0
XPointer Framework Recommendation
XPointer element() Scheme
XPointer xmlns() Scheme
XPointer xpointer() Scheme
nxslt.exe - XInclude enabled command line XSLT utility.
eXml - XInclude enabled XML ASP.NET Web Server control.

UPDATED WIKI: Home

olegt — Mon, 02 Jul 2007 11:20:10 GMT

Mvp.Xml Library:

XPathmania

Note: development for the .NET 1.1 is over. Here is last Mvp.Xml Library release for .NET 1.1.

UPDATED WIKI: Home

olegt — Mon, 02 Jul 2007 11:16:09 GMT

Mvp.Xml Library:

Common module
EXSLT.NET module
XInclude.NET module
XPointer.NET module

XPathmania

UPDATED WIKI: XInclude.NET

olegt — Mon, 02 Jul 2007 11:09:52 GMT

Mvp.Xml Project: XInclude.NET module

1. Usage

XIncludingReader class, found in the Mvp.Xml.XInclude namespace, is the key class. It's customized XmlReader, which implements streamable subset of the XInclude and XPointer in a fast, non-caching, forward-only fashion. It can be set on top of another XmlReader - such design allows to perform XML Inclusions in many different scenarios, e.g. before or after validation, before or after transforming XML etc. Here are some common usage scenarios:

XML inclusion during XML reading:

{{XmlReader reader = new XIncludingReader("source.xml"); while (reader.Read()) { ... }} XML inclusion while building XmlDocument: {{XmlReader reader = new XIncludingReader(XmlReader.Create("source.xml")); XmlDocument doc = new XmlDocument(); doc.Load(reader); ... }} XML inclusion before an XSL Transformation:

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("stylesheet.xsl");
XmlReader reader = new XIncludingReader("source.xml");
XPathDocument xdoc = new XPathDocument(reader);
xslt.Transform(xdoc, null, new StreamWriter("result.xml"));
...

2. Custom XmlResolver

3. XPointer

4. Conformance

XIncludingReader class implements the streamable subset of the XInclude - intra-document references are not supported. That means XIncludingReader treats an absence of an "href" attribute on an xi:include element as an XInclude resource error.
Syntactically incorrect URI references are treated as an XInclude resource error.
Only XPath subset of the xpointer() XPointer Scheme is supported.

5. Support

You can get support using the following options:

XInclude.NET Forum at the XML Lab
Mvp.Xml User Forum
Please feel free to report any bugs or suggest features via the Issue Tracker.

6. References

"Combining XML Documents with XInclude" by Oleg Tkachenko, MSDN
W3C XML Inclusions (XInclude)1.0
XPointer Framework Recommendation
XPointer element() Scheme
XPointer xmlns() Scheme
XPointer xpointer() Scheme
nxslt.exe - XInclude enabled command line XSLT utility.

UPDATED WIKI: Home

olegt — Mon, 02 Jul 2007 11:07:10 GMT

Mvp.Xml Library:

Common module
EXSLT.NET module
XInclude.NET module
XPointer.NET module

XPathmania

UPDATED WIKI: Home

olegt — Mon, 02 Jul 2007 11:00:51 GMT

Mvp.Xml Library:

Common module
EXSLT.NET module
XInclude.NET module
XPointer.NET module

XPathmania

UPDATED WIKI: XPointer.NET

olegt — Fri, 29 Jun 2007 17:04:46 GMT

tbd