2 // System.Xml.XmlDocument
5 // Daniel Weber (daniel-weber@austin.rr.com)
6 // Kral Ferch <kral_ferch@hotmail.com>
7 // Jason Diamond <jason@injektilo.org>
8 // Miguel de Icaza (miguel@ximian.com)
9 // Duncan Mak (duncan@ximian.com)
10 // Atsushi Enomoto (ginga@kit.hi-ho.ne.jp)
12 // (C) 2001 Daniel Weber
13 // (C) 2002 Kral Ferch, Jason Diamond, Miguel de Icaza, Duncan Mak,
20 using System.Xml.XPath;
21 using System.Diagnostics;
22 using System.Collections;
26 public class XmlDocument : XmlNode
30 XmlLinkedNode lastLinkedChild;
31 XmlNameTable nameTable;
32 string baseURI = String.Empty;
33 XmlImplementation implementation;
34 bool preserveWhitespace = false;
35 WeakReference reusableXmlTextReader;
41 public XmlDocument () : this (null, null)
45 protected internal XmlDocument (XmlImplementation imp) : this (imp, null)
49 public XmlDocument (XmlNameTable nt) : this (null, nt)
53 XmlDocument (XmlImplementation impl, XmlNameTable nt) : base (null)
55 implementation = (impl != null) ? impl : new XmlImplementation ();
56 nameTable = (nt != null) ? nt : implementation.internalNameTable;
57 AddDefaultNameTableKeys ();
63 public event XmlNodeChangedEventHandler NodeChanged;
65 public event XmlNodeChangedEventHandler NodeChanging;
67 public event XmlNodeChangedEventHandler NodeInserted;
69 public event XmlNodeChangedEventHandler NodeInserting;
71 public event XmlNodeChangedEventHandler NodeRemoved;
73 public event XmlNodeChangedEventHandler NodeRemoving;
79 public override string BaseURI {
85 // Used to read 'InnerXml's for its descendants at any place.
86 internal XmlTextReader ReusableReader {
88 if(reusableXmlTextReader == null)
89 reusableXmlTextReader = new WeakReference (null);
90 if(!reusableXmlTextReader.IsAlive) {
91 XmlTextReader reader = new XmlTextReader ((TextReader)null);
92 reusableXmlTextReader.Target = reader;
94 return (XmlTextReader)reusableXmlTextReader.Target;
98 public XmlElement DocumentElement {
100 XmlNode node = FirstChild;
102 while (node != null) {
103 if (node is XmlElement)
105 node = node.NextSibling;
108 return node != null ? node as XmlElement : null;
112 [MonoTODO("It doesn't have internal subset object model.")]
113 public virtual XmlDocumentType DocumentType {
115 foreach(XmlNode n in this.ChildNodes) {
116 if(n.NodeType == XmlNodeType.DocumentType)
117 return (XmlDocumentType)n;
123 public XmlImplementation Implementation {
124 get { return implementation; }
127 public override string InnerXml {
129 return base.InnerXml;
131 set { // reason for overriding
132 this.LoadXml (value);
136 public override bool IsReadOnly {
137 get { return false; }
140 internal override XmlLinkedNode LastLinkedChild {
142 return lastLinkedChild;
146 lastLinkedChild = value;
150 public override string LocalName {
151 get { return "#document"; }
154 public override string Name {
155 get { return "#document"; }
158 public XmlNameTable NameTable {
159 get { return nameTable; }
162 public override XmlNodeType NodeType {
163 get { return XmlNodeType.Document; }
166 internal override XPathNodeType XPathNodeType {
168 return XPathNodeType.Root;
172 public override XmlDocument OwnerDocument {
176 [MonoTODO("check its behavior")]
177 public bool PreserveWhitespace {
178 get { return preserveWhitespace; }
179 set { preserveWhitespace = value; }
182 internal override string XmlLang {
183 get { return String.Empty; }
187 public virtual XmlResolver XmlResolver {
188 set { throw new NotImplementedException (); }
191 internal override XmlSpace XmlSpace {
193 return XmlSpace.None;
201 [MonoTODO("Should BaseURI be cloned?")]
202 public override XmlNode CloneNode (bool deep)
204 XmlDocument doc = implementation.CreateDocument ();
205 doc.PreserveWhitespace = PreserveWhitespace; // required?
208 foreach(XmlNode n in ChildNodes)
209 doc.AppendChild (doc.ImportNode (n, deep));
214 public XmlAttribute CreateAttribute (string name)
216 return CreateAttribute (name, String.Empty);
219 public XmlAttribute CreateAttribute (string qualifiedName, string namespaceURI)
224 ParseName (qualifiedName, out prefix, out localName);
226 return CreateAttribute (prefix, localName, namespaceURI);
229 public virtual XmlAttribute CreateAttribute (string prefix, string localName, string namespaceURI)
231 if ((localName == null) || (localName == String.Empty))
232 throw new ArgumentException ("The attribute local name cannot be empty.");
234 return new XmlAttribute (prefix, localName, namespaceURI, this);
237 public virtual XmlCDataSection CreateCDataSection (string data)
239 return new XmlCDataSection (data, this);
242 public virtual XmlComment CreateComment (string data)
244 return new XmlComment (data, this);
248 protected internal virtual XmlAttribute CreateDefaultAttribute (string prefix, string localName, string namespaceURI)
250 throw new NotImplementedException ();
253 public virtual XmlDocumentFragment CreateDocumentFragment ()
255 return new XmlDocumentFragment (this);
258 public virtual XmlDocumentType CreateDocumentType (string name, string publicId,
259 string systemId, string internalSubset)
261 return new XmlDocumentType (name, publicId, systemId, internalSubset, this);
264 public XmlElement CreateElement (string name)
266 return CreateElement (name, String.Empty);
269 public XmlElement CreateElement (
270 string qualifiedName,
276 ParseName (qualifiedName, out prefix, out localName);
278 return CreateElement (prefix, localName, namespaceURI);
281 public virtual XmlElement CreateElement (
286 if ((localName == null) || (localName == String.Empty))
287 throw new ArgumentException ("The local name for elements or attributes cannot be null or an empty string.");
289 return new XmlElement (prefix != null ? prefix : String.Empty, localName, namespaceURI != null ? namespaceURI : String.Empty, this);
292 public virtual XmlEntityReference CreateEntityReference (string name)
294 return new XmlEntityReference (name, this);
298 internal protected virtual XPathNavigator CreateNavigator (XmlNode node)
300 throw new NotImplementedException ();
303 public virtual XmlNode CreateNode (
304 string nodeTypeString,
308 return CreateNode (GetNodeTypeFromString (nodeTypeString), name, namespaceURI);
311 public virtual XmlNode CreateNode (
316 string prefix = null;
317 string localName = name;
319 if ((type == XmlNodeType.Attribute) || (type == XmlNodeType.Element) || (type == XmlNodeType.EntityReference))
320 ParseName (name, out prefix, out localName);
322 return CreateNode (type, prefix, localName, namespaceURI);
325 public virtual XmlNode CreateNode (
332 case XmlNodeType.Attribute: return CreateAttribute (prefix, name, namespaceURI);
333 case XmlNodeType.CDATA: return CreateCDataSection (null);
334 case XmlNodeType.Comment: return CreateComment (null);
335 case XmlNodeType.Document: return new XmlDocument (); // TODO - test to see which constructor to use, i.e. use existing NameTable or not.
336 case XmlNodeType.DocumentFragment: return CreateDocumentFragment ();
337 case XmlNodeType.DocumentType: return CreateDocumentType (null, null, null, null);
338 case XmlNodeType.Element: return CreateElement (prefix, name, namespaceURI);
339 case XmlNodeType.EntityReference: return CreateEntityReference (null);
340 case XmlNodeType.ProcessingInstruction: return CreateProcessingInstruction (null, null);
341 case XmlNodeType.SignificantWhitespace: return CreateSignificantWhitespace (String.Empty);
342 case XmlNodeType.Text: return CreateTextNode (null);
343 case XmlNodeType.Whitespace: return CreateWhitespace (String.Empty);
344 case XmlNodeType.XmlDeclaration: return CreateXmlDeclaration ("1.0", null, null);
345 default: throw new ArgumentOutOfRangeException(String.Format("{0}\nParameter name: {1}",
346 "Specified argument was out of the range of valid values", type.ToString ()));
350 public virtual XmlProcessingInstruction CreateProcessingInstruction (
354 return new XmlProcessingInstruction (target, data, this);
357 public virtual XmlSignificantWhitespace CreateSignificantWhitespace (string text)
359 foreach (char c in text)
360 if ((c != ' ') && (c != '\r') && (c != '\n') && (c != '\t'))
361 throw new ArgumentException ("Invalid whitespace characters.");
363 return new XmlSignificantWhitespace (text, this);
366 public virtual XmlText CreateTextNode (string text)
368 return new XmlText (text, this);
371 public virtual XmlWhitespace CreateWhitespace (string text)
373 foreach (char c in text)
374 if ((c != ' ') && (c != '\r') && (c != '\n') && (c != '\t'))
375 throw new ArgumentException ("Invalid whitespace characters.");
377 return new XmlWhitespace (text, this);
380 public virtual XmlDeclaration CreateXmlDeclaration (string version, string encoding,
383 if (version != "1.0")
384 throw new ArgumentException ("version string is not correct.");
386 if ((standalone != null && standalone != String.Empty) && !((standalone == "yes") || (standalone == "no")))
387 throw new ArgumentException ("standalone string is not correct.");
389 return new XmlDeclaration (version, encoding, standalone, this);
393 public virtual XmlElement GetElementById (string elementId)
395 throw new NotImplementedException ();
398 public virtual XmlNodeList GetElementsByTagName (string name)
400 ArrayList nodeArrayList = new ArrayList ();
401 this.searchNodesRecursively (this, name, nodeArrayList);
402 return new XmlNodeArrayList (nodeArrayList);
405 private void searchNodesRecursively (XmlNode argNode, string argName,
406 ArrayList argArrayList)
408 XmlNodeList xmlNodeList = argNode.ChildNodes;
409 foreach (XmlNode node in xmlNodeList){
410 if (node.Name.Equals (argName))
411 argArrayList.Add (node);
413 this.searchNodesRecursively (node, argName, argArrayList);
417 private void searchNodesRecursively (XmlNode argNode, string argName, string argNamespaceURI,
418 ArrayList argArrayList)
420 XmlNodeList xmlNodeList = argNode.ChildNodes;
421 foreach (XmlNode node in xmlNodeList){
422 if (node.LocalName.Equals (argName) && node.NamespaceURI.Equals (argNamespaceURI))
423 argArrayList.Add (node);
425 this.searchNodesRecursively (node, argName, argNamespaceURI, argArrayList);
429 public virtual XmlNodeList GetElementsByTagName (string localName, string namespaceURI)
431 ArrayList nodeArrayList = new ArrayList ();
432 this.searchNodesRecursively (this, localName, namespaceURI, nodeArrayList);
433 return new XmlNodeArrayList (nodeArrayList);
436 private XmlNodeType GetNodeTypeFromString (string nodeTypeString)
438 switch (nodeTypeString) {
439 case "attribute": return XmlNodeType.Attribute;
440 case "cdatasection": return XmlNodeType.CDATA;
441 case "comment": return XmlNodeType.Comment;
442 case "document": return XmlNodeType.Document;
443 case "documentfragment": return XmlNodeType.DocumentFragment;
444 case "documenttype": return XmlNodeType.DocumentType;
445 case "element": return XmlNodeType.Element;
446 case "entityreference": return XmlNodeType.EntityReference;
447 case "processinginstruction": return XmlNodeType.ProcessingInstruction;
448 case "significantwhitespace": return XmlNodeType.SignificantWhitespace;
449 case "text": return XmlNodeType.Text;
450 case "whitespace": return XmlNodeType.Whitespace;
452 throw new ArgumentException(String.Format("The string doesn't represent any node type : {0}.", nodeTypeString));
456 [MonoTODO("default attributes (of imported doc); Entity; Notation")]
457 public virtual XmlNode ImportNode (XmlNode node, bool deep)
459 switch(node.NodeType)
461 case XmlNodeType.Attribute:
463 XmlAttribute src_att = node as XmlAttribute;
464 XmlAttribute dst_att = this.CreateAttribute (src_att.Prefix, src_att.LocalName, src_att.NamespaceURI);
465 dst_att.Value = src_att.Value; // always explicitly specified (whether source is specified or not)
469 case XmlNodeType.CDATA:
470 return this.CreateCDataSection (node.Value);
472 case XmlNodeType.Comment:
473 return this.CreateComment (node.Value);
475 case XmlNodeType.Document:
476 throw new XmlException ("Document cannot be imported.");
478 case XmlNodeType.DocumentFragment:
480 XmlDocumentFragment df = this.CreateDocumentFragment ();
483 foreach(XmlNode n in node.ChildNodes)
485 df.AppendChild (this.ImportNode (n, deep));
491 case XmlNodeType.DocumentType:
492 throw new XmlException ("DocumentType cannot be imported.");
494 case XmlNodeType.Element:
496 XmlElement src = (XmlElement)node;
497 XmlElement dst = this.CreateElement (src.Prefix, src.LocalName, src.NamespaceURI);
498 foreach(XmlAttribute attr in src.Attributes)
500 if(attr.Specified) // copies only specified attributes
501 dst.SetAttributeNode ((XmlAttribute)this.ImportNode (attr, deep));
502 if(DocumentType != null)
504 // TODO: create default attribute values
509 foreach(XmlNode n in src.ChildNodes)
510 dst.AppendChild (this.ImportNode (n, deep));
515 case XmlNodeType.EndElement:
516 throw new XmlException ("Illegal ImportNode call for NodeType.EndElement");
517 case XmlNodeType.EndEntity:
518 throw new XmlException ("Illegal ImportNode call for NodeType.EndEntity");
520 case XmlNodeType.Entity:
521 throw new NotImplementedException (); // TODO
523 case XmlNodeType.EntityReference:
524 return this.CreateEntityReference (node.Name);
526 case XmlNodeType.None:
527 throw new XmlException ("Illegal ImportNode call for NodeType.None");
529 case XmlNodeType.Notation:
530 throw new NotImplementedException (); // TODO
532 case XmlNodeType.ProcessingInstruction:
533 XmlProcessingInstruction pi = node as XmlProcessingInstruction;
534 return this.CreateProcessingInstruction (pi.Target, pi.Data);
536 case XmlNodeType.SignificantWhitespace:
537 return this.CreateSignificantWhitespace (node.Value);
539 case XmlNodeType.Text:
540 return this.CreateTextNode (node.Value);
542 case XmlNodeType.Whitespace:
543 return this.CreateWhitespace (node.Value);
545 case XmlNodeType.XmlDeclaration:
546 XmlDeclaration srcDecl = node as XmlDeclaration;
547 return this.CreateXmlDeclaration (srcDecl.Version, srcDecl.Encoding, srcDecl.Standalone);
550 throw new NotImplementedException ();
554 public virtual void Load (Stream inStream)
556 XmlReader xmlReader = new XmlTextReader (inStream);
560 public virtual void Load (string filename)
563 XmlReader xmlReader = new XmlTextReader (new StreamReader (filename));
567 public virtual void Load (TextReader txtReader)
569 Load (new XmlTextReader (txtReader));
572 public virtual void Load (XmlReader xmlReader)
574 // Reset our document
575 // For now this just means removing all our children but later this
576 // may turn out o need to call a private method that resets other things
577 // like properties we have, etc.
580 XmlNode currentNode = this;
583 XmlNode n = ReadNode (xmlReader);
589 public virtual void LoadXml (string xml)
591 XmlReader xmlReader = new XmlTextReader (new StringReader (xml));
595 internal void onNodeChanged (XmlNode node, XmlNode Parent)
597 if (NodeChanged != null)
598 NodeChanged (node, new XmlNodeChangedEventArgs
599 (XmlNodeChangedAction.Change,
600 node, Parent, Parent));
603 internal void onNodeChanging(XmlNode node, XmlNode Parent)
605 if (NodeChanging != null)
606 NodeChanging (node, new XmlNodeChangedEventArgs
607 (XmlNodeChangedAction.Change,
608 node, Parent, Parent));
611 internal void onNodeInserted (XmlNode node, XmlNode newParent)
613 if (NodeInserted != null)
614 NodeInserted (node, new XmlNodeChangedEventArgs
615 (XmlNodeChangedAction.Insert,
616 node, null, newParent));
619 internal void onNodeInserting (XmlNode node, XmlNode newParent)
621 if (NodeInserting != null)
622 NodeInserting (node, new XmlNodeChangedEventArgs
623 (XmlNodeChangedAction.Insert,
624 node, null, newParent));
627 internal void onNodeRemoved (XmlNode node, XmlNode oldParent)
629 if (NodeRemoved != null)
630 NodeRemoved (node, new XmlNodeChangedEventArgs
631 (XmlNodeChangedAction.Remove,
632 node, oldParent, null));
635 internal void onNodeRemoving (XmlNode node, XmlNode oldParent)
637 if (NodeRemoving != null)
638 NodeRemoving (node, new XmlNodeChangedEventArgs
639 (XmlNodeChangedAction.Remove,
640 node, oldParent, null));
643 private void ParseName (string name, out string prefix, out string localName)
645 int indexOfColon = name.IndexOf (':');
647 if (indexOfColon != -1) {
648 prefix = name.Substring (0, indexOfColon);
649 localName = name.Substring (indexOfColon + 1);
656 // Reads XmlReader and creates Attribute Node.
657 private XmlAttribute ReadAttributeNode(XmlReader reader)
659 if(reader.NodeType == XmlNodeType.Element)
660 reader.MoveToFirstAttribute ();
661 else if(reader.NodeType != XmlNodeType.Attribute)
662 throw new InvalidOperationException ("bad position to read attribute.");
663 XmlAttribute attribute = CreateAttribute (reader.Prefix, reader.LocalName, reader.NamespaceURI);
664 ReadAttributeNodeValue (reader, attribute);
668 // Reads attribute from XmlReader and then creates attribute value children. XmlAttribute also uses this.
669 internal void ReadAttributeNodeValue(XmlReader reader, XmlAttribute attribute)
671 while(reader.ReadAttributeValue ()) {
672 if(reader.NodeType == XmlNodeType.EntityReference)
673 // FIXME: if DocumentType is available, then try to resolve it.
674 attribute.AppendChild (CreateEntityReference (reader.Name));
675 // FIXME: else if(NodeType == EndEntity) -- reset BaseURI and so on -- ;
677 // (IMHO) Children of Attribute is likely restricted to Text and EntityReference.
678 attribute.AppendChild (CreateTextNode (reader.Value));
682 [MonoTODO("DTD parser is not completed.")]
683 public virtual XmlNode ReadNode(XmlReader reader)
685 // This logic was formerly defined in 'XmlNode.ConstructDOM()'
687 XmlNode resultNode = null;
688 XmlNode newNode = null;
689 XmlNode currentNode = null;
690 // It was originally XmlDocument.Load(reader reader) when mcs was v0.16.
691 int startDepth = reader.Depth;
693 bool ignoredWhitespace;
696 ignoredWhitespace = false;
698 // This complicated check is because we shouldn't make
699 // improper additional XmlReader.Read() by this method itself.
700 if(atStart && (reader.NodeType == XmlNodeType.EndElement ||
701 reader.NodeType == XmlNodeType.EndEntity))
702 throw new InvalidOperationException ("the XmlReader now holds invalid position.");
704 switch (reader.NodeType) {
706 case XmlNodeType.Attribute:
707 newNode = ReadAttributeNode (reader);
710 case XmlNodeType.CDATA:
711 newNode = CreateCDataSection (reader.Value);
712 if(currentNode != null)
713 currentNode.AppendChild (newNode);
716 case XmlNodeType.Comment:
717 newNode = CreateComment (reader.Value);
718 if(currentNode != null)
719 currentNode.AppendChild (newNode);
722 case XmlNodeType.Element:
723 XmlElement element = CreateElement (reader.Prefix, reader.LocalName, reader.NamespaceURI);
724 element.IsEmpty = reader.IsEmptyElement;
725 if(currentNode != null)
726 currentNode.AppendChild (element);
728 resultNode = element;
730 // set the element's attributes.
731 while (reader.MoveToNextAttribute ()) {
733 XmlAttribute attribute = CreateAttribute (reader.Prefix, reader.LocalName, reader.NamespaceURI);
734 attribute.Value = reader.Value;
735 element.SetAttributeNode (attribute);
737 element.SetAttributeNode (ReadAttributeNode (reader));
740 reader.MoveToElement ();
742 if (!reader.IsEmptyElement)
743 currentNode = element;
747 case XmlNodeType.EndElement:
748 if(currentNode.Name != reader.Name)
749 throw new XmlException ("mismatch end tag.");
750 currentNode = currentNode.ParentNode;
753 case XmlNodeType.EndEntity:
754 break; // no operation
756 case XmlNodeType.ProcessingInstruction:
757 newNode = CreateProcessingInstruction (reader.Name, reader.Value);
758 if(currentNode != null)
759 currentNode.AppendChild (newNode);
762 case XmlNodeType.Text:
763 newNode = CreateTextNode (reader.Value);
764 if(currentNode != null)
765 currentNode.AppendChild (newNode);
768 case XmlNodeType.XmlDeclaration:
769 // empty strings are dummy, then gives over setting value contents to setter.
770 newNode = CreateXmlDeclaration ("1.0" , String.Empty, String.Empty);
771 ((XmlDeclaration)newNode).Value = reader.Value;
772 if(currentNode != null)
773 throw new XmlException ("XmlDeclaration at invalid position.");
776 case XmlNodeType.DocumentType:
777 // This logic is kinda hack;-)
778 XmlTextReader xtReader = reader as XmlTextReader;
779 if(xtReader == null) {
780 xtReader = new XmlTextReader (reader.ReadOuterXml (),
781 XmlNodeType.DocumentType,
782 new XmlParserContext (NameTable, ConstructNamespaceManager(), XmlLang, XmlSpace));
785 newNode = CreateDocumentType (xtReader.Name,
786 xtReader.GetAttribute ("PUBLIC"),
787 xtReader.GetAttribute ("SYSTEM"),
789 if(currentNode != null)
790 throw new XmlException ("XmlDocumentType at invalid position.");
793 case XmlNodeType.EntityReference:
794 newNode = CreateEntityReference (reader.Name);
795 if(currentNode != null)
796 currentNode.AppendChild (newNode);
799 case XmlNodeType.SignificantWhitespace:
800 newNode = CreateSignificantWhitespace (reader.Value);
801 if(currentNode != null)
802 currentNode.AppendChild (newNode);
805 case XmlNodeType.Whitespace:
806 if(PreserveWhitespace) {
807 newNode = CreateWhitespace (reader.Value);
808 if(currentNode != null)
809 currentNode.AppendChild (newNode);
812 ignoredWhitespace = true;
815 } while(ignoredWhitespace ||
816 reader.Depth > startDepth ||
817 // This complicated condition is because reader.Depth was set
818 // before XmlTextReader.depth increments ;-)
819 (reader.Depth == startDepth && reader.NodeType == XmlNodeType.Element && reader.IsEmptyElement == false)
821 return resultNode != null ? resultNode : newNode;
824 public virtual void Save(Stream outStream)
826 XmlTextWriter xmlWriter = new XmlTextWriter (outStream, Encoding.UTF8);
827 WriteContentTo (xmlWriter);
831 public virtual void Save (string filename)
833 XmlTextWriter xmlWriter = new XmlTextWriter (filename, Encoding.UTF8);
834 WriteContentTo (xmlWriter);
839 public virtual void Save (TextWriter writer)
841 XmlTextWriter xmlWriter = new XmlTextWriter (writer);
842 WriteContentTo (xmlWriter);
846 public virtual void Save (XmlWriter xmlWriter)
849 // This should preserve white space if PreserveWhiteSpace is true
851 WriteContentTo (xmlWriter);
855 public override void WriteContentTo (XmlWriter w)
857 foreach(XmlNode childNode in ChildNodes) {
858 childNode.WriteTo (w);
859 if(!PreserveWhitespace) {
865 public override void WriteTo (XmlWriter w)
870 private void AddDefaultNameTableKeys ()
872 // The following keys are default of MS .NET Framework
873 nameTable.Add ("#text");
874 nameTable.Add ("xml");
875 nameTable.Add ("xmlns");
876 nameTable.Add ("#entity");
877 nameTable.Add ("#document-fragment");
878 nameTable.Add ("#comment");
879 nameTable.Add ("space");
880 nameTable.Add ("id");
881 nameTable.Add ("#whitespace");
882 nameTable.Add ("http://www.w3.org/2000/xmlns/");
883 nameTable.Add ("#cdata-section");
884 nameTable.Add ("lang");
885 nameTable.Add ("#document");
886 nameTable.Add ("#significant-whitespace");