I am now learning XmlDocument
but I've just ran into XDocument
and when I try to search the difference or benefits of them I can't find something useful, could you please tell me why you would use one over another ?
-
16I'm wondering why the documentation guys in Microsoft did not put any note or remark in MSDN to clarify their differences or when to use what.– Kamran BigdelyMay 21, 2015 at 17:43
-
1Some info on msdn: msdn.microsoft.com/en-us/library/…. And a performance question: stackoverflow.com/questions/4383919/…. Personally I have found it easier to work with LINQ to XML.– nawfalAug 19, 2015 at 10:09
7 Answers
If you're using .NET version 3.0 or lower, you have to use XmlDocument
aka the classic DOM API. Likewise you'll find there are some other APIs which will expect this.
If you get the choice, however, I would thoroughly recommend using XDocument
aka LINQ to XML. It's much simpler to create documents and process them. For example, it's the difference between:
XmlDocument doc = new XmlDocument();
XmlElement root = doc.CreateElement("root");
root.SetAttribute("name", "value");
XmlElement child = doc.CreateElement("child");
child.InnerText = "text node";
root.AppendChild(child);
doc.AppendChild(root);
and
XDocument doc = new XDocument(
new XElement("root",
new XAttribute("name", "value"),
new XElement("child", "text node")));
Namespaces are pretty easy to work with in LINQ to XML, unlike any other XML API I've ever seen:
XNamespace ns = "http://somewhere.com";
XElement element = new XElement(ns + "elementName");
// etc
LINQ to XML also works really well with LINQ - its construction model allows you to build elements with sequences of sub-elements really easily:
// Customers is a List<Customer>
XElement customersElement = new XElement("customers",
customers.Select(c => new XElement("customer",
new XAttribute("name", c.Name),
new XAttribute("lastSeen", c.LastOrder)
new XElement("address",
new XAttribute("town", c.Town),
new XAttribute("firstline", c.Address1),
// etc
));
It's all a lot more declarative, which fits in with the general LINQ style.
Now as Brannon mentioned, these are in-memory APIs rather than streaming ones (although XStreamingElement
supports lazy output). XmlReader
and XmlWriter
are the normal ways of streaming XML in .NET, but you can mix all the APIs to some extent. For example, you can stream a large document but use LINQ to XML by positioning an XmlReader
at the start of an element, reading an XElement
from it and processing it, then moving on to the next element etc. There are various blog posts about this technique, here's one I found with a quick search.
-
Could you tell me why they are different ? I mean yeah XDocument looks pretty neat but as for DOM level difference, aren't they both xml, is there any scheme that shows both Microsoft X-DOM and W3C Compliant DOM ? Thanks.– TarikOct 9, 2009 at 6:36
-
3What do you mean by "scheme" and what do you mean by "shows"? Yes, they both deal with standard XML, but LINQ to XML is just a nicer API for most things. A lot of the technology behind LINQ to XML simply wasn't available before .NET 3.5. Oct 9, 2009 at 6:39
-
-
6Well they're both APIs for XML itself, so in that sense they're not different, no. I suspect both have some limitations (and there's a LINQ to XML one which I know about but can't remember off the top of my head) but in most cases you can just treat them as being the same model with slightly different representations. Oct 9, 2009 at 7:09
-
1@SensorSmith: That doesn't cover all the other bonuses though, like automatic flattening of sequences, handling of DateTime etc. You could add extensions methods for all that too, but why reinvent LINQ to XML when you can just use it instead? Oct 28, 2015 at 22:43
I am surprised none of the answers so far mentions the fact that XmlDocument
provides no line information, while XDocument
does (through the IXmlLineInfo
interface).
This can be a critical feature in some cases (for example if you want to report errors in an XML, or keep track of where elements are defined in general) and you better be aware of this before you happily start to implement using XmlDocument
, to later discover you have to change it all.
-
1And I am surprised nobody noticed that your statement is inversely true. XmlDocument DOES provide the line information while XDocument doesn't.– VVSDec 29, 2017 at 11:46
-
6@VVS: you got me worried for a moment that I had made a terrible typo, but after double checking, I confirm that
XDocument
does provide line information. See XDocument.Load withLoadOptions.SetLineInfo
as a second argument. If you know a way to get line information withXmlDocument
I am curious; back when I wrote this answer I couldn't find any. This other answer seems to confirm: stackoverflow.com/a/33622102/253883 Dec 31, 2017 at 19:18 -
2"and you better be aware of this before you happily start to implement using XmlDocument, to later discover you have to change it all." Guess what I just did :)– PaulJun 28, 2019 at 9:39
XmlDocument
is great for developers who are familiar with the XML DOM object model. It's been around for a while, and more or less corresponds to a W3C standard. It supports manual navigation as well as XPath
node selection.
XDocument
powers the LINQ to XML feature in .NET 3.5. It makes heavy use of IEnumerable<>
and can be easier to work with in straight C#.
Both document models require you to load the entire document into memory (unlike XmlReader
for example).
-
3I think you meant "and can be easier to work with in straight VB.net". Because VB supports direct creation of elements where C# still requires code. Apr 27, 2017 at 15:46
As mentioned elsewhere, undoubtedly, Linq to Xml makes creation and alteration of xml documents a breeze in comparison to XmlDocument
, and the XNamespace ns + "elementName"
syntax makes for pleasurable reading when dealing with namespaces.
One thing worth mentioning for xsl
and xpath
die hards to note is that it IS possible to still execute arbitrary xpath 1.0
expressions on Linq 2 Xml XNodes
by including:
using System.Xml.XPath;
and then we can navigate and project data using xpath
via these extension methods:
- XPathSelectElement - Single Element
- XPathSelectElements - Node Set
- XPathEvaluate - Scalars and others
For instance, given the Xml document:
<xml>
<foo>
<baz id="1">10</baz>
<bar id="2" special="1">baa baa</bar>
<baz id="3">20</baz>
<bar id="4" />
<bar id="5" />
</foo>
<foo id="123">Text 1<moo />Text 2
</foo>
</xml>
We can evaluate:
var node = xele.XPathSelectElement("/xml/foo[@id='123']");
var nodes = xele.XPathSelectElements(
"//moo/ancestor::xml/descendant::baz[@id='1']/following-sibling::bar[not(@special='1')]");
var sum = xele.XPathEvaluate("sum(//foo[not(moo)]/baz)");
XDocument
is from the LINQ to XML API, and XmlDocument
is the standard DOM-style API for XML. If you know DOM well, and don't want to learn LINQ to XML, go with XmlDocument
. If you're new to both, check out this page that compares the two, and pick which one you like the looks of better.
I've just started using LINQ to XML, and I love the way you create an XML document using functional construction. It's really nice. DOM is clunky in comparison.
Also, note that XDocument
is supported in Xbox 360 and Windows Phone OS 7.0.
If you target them, develop for XDocument
or migrate from XmlDocument
.
I believe that XDocument
makes a lot more object creation calls. I suspect that for when you're handling a lot of XML documents, XMLDocument
will be faster.
One place this happens is in managing scan data. Many scan tools output their data in XML (for obvious reasons). If you have to process a lot of these scan files, I think you'll have better performance with XMLDocument
.
-
12I think you should back your comment up with figures next time, as I believe you may be wrong. See blogs.msdn.com/b/codejunkie/archive/2008/10/08/…– mikeJun 18, 2012 at 6:58