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 = true; // Its true initial value is 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;
582 // This method of XmlNode is previously written here.
583 // Then I(ginga) moved them to use this logic with XmlElement.
584 this.ConstructDOM(xmlReader, currentNode);
587 public virtual void LoadXml (string xml)
589 XmlReader xmlReader = new XmlTextReader (new StringReader (xml));
593 internal void onNodeChanged (XmlNode node, XmlNode Parent)
595 if (NodeChanged != null)
596 NodeChanged (node, new XmlNodeChangedEventArgs
597 (XmlNodeChangedAction.Change,
598 node, Parent, Parent));
601 internal void onNodeChanging(XmlNode node, XmlNode Parent)
603 if (NodeChanging != null)
604 NodeChanging (node, new XmlNodeChangedEventArgs
605 (XmlNodeChangedAction.Change,
606 node, Parent, Parent));
609 internal void onNodeInserted (XmlNode node, XmlNode newParent)
611 if (NodeInserted != null)
612 NodeInserted (node, new XmlNodeChangedEventArgs
613 (XmlNodeChangedAction.Insert,
614 node, null, newParent));
617 internal void onNodeInserting (XmlNode node, XmlNode newParent)
619 if (NodeInserting != null)
620 NodeInserting (node, new XmlNodeChangedEventArgs
621 (XmlNodeChangedAction.Insert,
622 node, null, newParent));
625 internal void onNodeRemoved (XmlNode node, XmlNode oldParent)
627 if (NodeRemoved != null)
628 NodeRemoved (node, new XmlNodeChangedEventArgs
629 (XmlNodeChangedAction.Remove,
630 node, oldParent, null));
633 internal void onNodeRemoving (XmlNode node, XmlNode oldParent)
635 if (NodeRemoving != null)
636 NodeRemoving (node, new XmlNodeChangedEventArgs
637 (XmlNodeChangedAction.Remove,
638 node, oldParent, null));
641 private void ParseName (string name, out string prefix, out string localName)
643 int indexOfColon = name.IndexOf (':');
645 if (indexOfColon != -1) {
646 prefix = name.Substring (0, indexOfColon);
647 localName = name.Substring (indexOfColon + 1);
655 public virtual XmlNode ReadNode(XmlReader reader)
657 throw new NotImplementedException ();
660 public virtual void Save(Stream outStream)
662 XmlTextWriter xmlWriter = new XmlTextWriter (outStream, Encoding.UTF8);
663 WriteContentTo (xmlWriter);
667 public virtual void Save (string filename)
669 XmlTextWriter xmlWriter = new XmlTextWriter (filename, Encoding.UTF8);
670 WriteContentTo (xmlWriter);
675 public virtual void Save (TextWriter writer)
677 XmlTextWriter xmlWriter = new XmlTextWriter (writer);
678 WriteContentTo (xmlWriter);
682 public virtual void Save (XmlWriter xmlWriter)
685 // This should preserve white space if PreserveWhiteSpace is true
687 WriteContentTo (xmlWriter);
691 public override void WriteContentTo (XmlWriter w)
693 foreach(XmlNode childNode in ChildNodes) {
694 childNode.WriteTo (w);
695 if(!PreserveWhitespace) {
701 public override void WriteTo (XmlWriter w)
706 private void AddDefaultNameTableKeys ()
708 // The following keys are default of MS .NET Framework
709 nameTable.Add ("#text");
710 nameTable.Add ("xml");
711 nameTable.Add ("xmlns");
712 nameTable.Add ("#entity");
713 nameTable.Add ("#document-fragment");
714 nameTable.Add ("#comment");
715 nameTable.Add ("space");
716 nameTable.Add ("id");
717 nameTable.Add ("#whitespace");
718 nameTable.Add ("http://www.w3.org/2000/xmlns/");
719 nameTable.Add ("#cdata-section");
720 nameTable.Add ("lang");
721 nameTable.Add ("#document");
722 nameTable.Add ("#significant-whitespace");