No support for namespaces, no intention of eventual serialization. Everything is case-insensitive, but preserves case. Not thread safe. More...

Public Member Functions
	Node (string localName)

	Node (XmlElement e, IIssueReceiver ir)
	Builds a tree of Nodes from the specified XML subtree. Duplicate attributes are sent to 'ir' More...

IList< Node >	childrenByName (string elementName)
	Returns the subset of Children with a matching element name. (Case-insensitive) More...

string	queryAttr (string selector)
	Queryies the subtree for the specified attribute on the specified element. Example selector: element.element.attrname Assumes that the last segment of the selector is an attribute name. Throws an ArgumentException if there is only one segment ( element ). Uses the cache. More...

string	queryAttr (string nodeSelector, string attrName)

Node	queryFirst (string selector)

void	setAttr (string selector, string attrValue)
	Sets the specified attribute value, creating parent elements if needed. Clears the query cache. More...

void	setAttr (string nodeSelector, string attrName, string attrValue)
	Sets the specified attribute value, creating parent elements if needed. Clears the query cache. More...

Node	makeNodeTree (string selector)
	Traverses the specified path, creating any missing elements along the way. Uses existing nodes if found. More...

ICollection< Node >	query (string selector)
	Same as query(), except results are cached until clearQueryCache() is called. Faster, but can be incorrect if existing nodes are renamed, moved, or deleted. More...

void	clearQueryCache ()

ICollection< Node >	queryUncached (string selector)

Node	deepCopy ()
	Makes a recusive copy of the subtree, keeping no duplicate references to mutable types. More...

XmlElement	ToXmlElement ()

XmlElement	ToXmlElement (XmlDocument doc)

override string	ToString ()

Static Public Member Functions
static Node	FromXmlFragment (string xml, IssueSink sink)

Protected Member Functions
KeyValuePair< string, string >	parseAttributeName (string selector)

Protected Attributes
Dictionary< string, ICollection< Node > >	_cachedResults = new Dictionary<string, ICollection<Node>>(StringComparer.OrdinalIgnoreCase)

Properties
NameValueCollection	Attrs `[get, set]`
	Attributes More...

string	this[string name] `[get, set]`
	Access attributes by name More...

string	TextContents `[get, set]`
	The concatenated text, significant whitespace, and entity references within this element. Not XML compliant for sure. More...

string	Name `[get, set]`
	The name of the element. More...

List< Node >	Children `[get, set]`
	Child nodes More...

bool	IsEmpty `[get]`
	Returns true if the element has neither attributes nor children. More...

Detailed Description

No support for namespaces, no intention of eventual serialization. Everything is case-insensitive, but preserves case. Not thread safe.

Definition at line 15 of file Node.cs.

Constructor & Destructor Documentation

ImageResizer.Configuration.Xml.Node.Node	(	XmlElement	e,
		IIssueReceiver	ir
	)

inline

Builds a tree of Nodes from the specified XML subtree. Duplicate attributes are sent to 'ir'

Parameters

e
ir

Definition at line 24 of file Node.cs.

                                                      {
             name = e.LocalName;
             //Copy attributes, raising an issue if duplicates are found
             foreach (XmlAttribute a in e.Attributes) {
                 if (attrs[a.LocalName] != null){
                     ir.AcceptIssue(new Issue("Two or more attributes named " + a.LocalName + " found on element " + name + " in " 
                                             + e.ParentNode != null ? e.ParentNode.Name : "(unknown node)"));
                 }
                 attrs[a.LocalName] = a.Value;
             }
             //Parse children
             if (e.HasChildNodes) {
                 StringBuilder sb = null;
                 foreach (XmlNode n in e.ChildNodes) {
                     if (n.NodeType == XmlNodeType.Element) {
                         XmlElement child = n as XmlElement;
                         if (child != null) children.Add(new Node(child, ir));
                     //Collect text and whitespace
                     } else if (n.NodeType == XmlNodeType.Text || n.NodeType == XmlNodeType.EntityReference || n.NodeType == XmlNodeType.SignificantWhitespace) { //|| n.NodeType == XmlNodeType.Whitespace
                         if (sb == null) sb = new StringBuilder();
                         sb.Append(n.Value);
                     }
                 }
                 //Save text/whitespace
                 if (sb != null) TextContents = sb.ToString();
             }
             
         }

Member Function Documentation

IList<Node> ImageResizer.Configuration.Xml.Node.childrenByName ( string elementName )

inline

Returns the subset of Children with a matching element name. (Case-insensitive)

Parameters

elementName

Returns

Definition at line 102 of file Node.cs.

                                                               {
             List<Node> results = new List<Node>();
             if (children == null || children.Count == 0) return results;
             foreach(Node n in children)
                 if (n.Name.Equals(elementName, StringComparison.OrdinalIgnoreCase)) results.Add(n);
                 
             return results;
         }

Node ImageResizer.Configuration.Xml.Node.deepCopy ( )

inline

Makes a recusive copy of the subtree, keeping no duplicate references to mutable types.

Returns

Definition at line 244 of file Node.cs.

                                {
             Node n = new Node(this.name);
             //copy attrs
             foreach (string key in this.Attrs.Keys) {
                 n[key] = this[key];
             }
             
             //copy children recursive
             if (this.children != null)
                 foreach (Node c in this.Children)
                     n.Children.Add(c.deepCopy());
             //Copy text contents
             n.TextContents = this.TextContents;
 
             return n;
         }

Node ImageResizer.Configuration.Xml.Node.makeNodeTree ( string selector )

inline

Traverses the specified path, creating any missing elements along the way. Uses existing nodes if found.

Parameters

selector

Returns

Definition at line 171 of file Node.cs.

                                                   {
             Node n = this;
             Selector s = new Selector(selector);
             foreach (string part in s) {
                 IList<Node> results = n.childrenByName(part);
                 //Add it if doesn't exist
                 if (results == null || results.Count == 0) {
                     Node newNode = new Node(part);
                     if (n.children == null) n.children = new List<Node>();
                     n.Children.Add(newNode);
                     n = newNode;
                 } else {
                     n = results[0];
                 }
             }
             return n;
         }

ICollection<Node> ImageResizer.Configuration.Xml.Node.query ( string selector )

inline

Same as query(), except results are cached until clearQueryCache() is called. Faster, but can be incorrect if existing nodes are renamed, moved, or deleted.

Parameters

selector

Returns

Definition at line 196 of file Node.cs.

                                                         {
             
             if (_cachedResults.ContainsKey(selector)) return _cachedResults[selector];
 
             IList<Node> uncachedResults = queryUncached(selector) as IList<Node>;
             //cache miss
             ICollection<Node> results = _cachedResults[selector] = uncachedResults != null ? new ReadOnlyCollection<Node>(uncachedResults) : null;
             return results;
         }

string ImageResizer.Configuration.Xml.Node.queryAttr ( string selector )

inline

Queryies the subtree for the specified attribute on the specified element. Example selector: element.element.attrname Assumes that the last segment of the selector is an attribute name. Throws an ArgumentException if there is only one segment ( element ). Uses the cache.

Parameters

selector

Returns

Definition at line 119 of file Node.cs.

                                                  {
             KeyValuePair<string, string> parsed = parseAttributeName(selector);
             return queryAttr(parsed.Key, parsed.Value);
         }

void ImageResizer.Configuration.Xml.Node.setAttr	(	string	selector,
		string	attrValue
	)

inline

Sets the specified attribute value, creating parent elements if needed. Clears the query cache.

Parameters

selector
attrValue

Definition at line 149 of file Node.cs.

                                                                {
 
             KeyValuePair<string, string> parsed = parseAttributeName(selector);
             setAttr(parsed.Key, parsed.Value, attrValue);
         }

void ImageResizer.Configuration.Xml.Node.setAttr	(	string	nodeSelector,
		string	attrName,
		string	attrValue
	)

inline

Sets the specified attribute value, creating parent elements if needed. Clears the query cache.

Parameters

nodeSelector
attrName
attrValue

Definition at line 160 of file Node.cs.

                                                                                     {
             Node n = queryFirst(nodeSelector);
             if (n == null) n = makeNodeTree(nodeSelector);
             n.Attrs[attrName] = attrValue;
             this.clearQueryCache();
         }

Property Documentation

NameValueCollection ImageResizer.Configuration.Xml.Node.Attrs

getset

Attributes

Definition at line 56 of file Node.cs.

Referenced by ImageResizer.Plugins.DiskCache.CleanupStrategy.LoadFrom(), and ImageResizer.Configuration.PluginConfig.loadPluginsInternal().

List<Node> ImageResizer.Configuration.Xml.Node.Children

getset

Child nodes

Definition at line 93 of file Node.cs.

Referenced by ImageResizer.Configuration.PluginConfig.loadPluginsInternal().

bool ImageResizer.Configuration.Xml.Node.IsEmpty

get

Returns true if the element has neither attributes nor children.

Definition at line 264 of file Node.cs.

string ImageResizer.Configuration.Xml.Node.Name

getset

The name of the element.

Definition at line 84 of file Node.cs.

Referenced by ImageResizer.Configuration.Xml.Node.childrenByName(), and ImageResizer.Configuration.PluginConfig.loadPluginsInternal().

string ImageResizer.Configuration.Xml.Node.TextContents

getset

The concatenated text, significant whitespace, and entity references within this element. Not XML compliant for sure.

Definition at line 77 of file Node.cs.

string ImageResizer.Configuration.Xml.Node.this[string name]

getset

Access attributes by name

Parameters

name

Returns

Definition at line 65 of file Node.cs.

The documentation for this class was generated from the following file:

C:/Users/nathanael/Documents/resizer/Core/Configuration/Xml/Node.cs

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation