#region License and Copyright
/*
 * Dotnet Commons Xml
 *
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
 * (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the
 * Free Software Foundation, Inc.,
 * 59 Temple Place,
 * Suite 330,
 * Boston,
 * MA 02111-1307
 * USA
 *
 */
#endregion
 
using System;
using System.Collections;
using System.Collections.Specialized;
using System.Diagnostics;
using System.IO;
using System.Reflection;
using System.Text;
using System.Text.RegularExpressions;
using System.Xml;
using System.Xml.Xsl;
using System.Xml.Serialization;
 
//using Dotnet.Commons.Reflection;
 
namespace Dotnet.Commons.Xml
{
 
    ///
    ///
<summary>
    /// This utility class contains wrapper functions that help to ease the handling and
    /// manipulation of Xml documents, such as adding an element, adding an attribute
    /// to an element, copying and cloning of nodes, etc.
    ///
    /// </summary>
 
    /// 
 
    public abstract class XmlUtils
    {
        /// -------------------------------------------------------------------
        ///
<summary>
        /// Adds an <see cref="XmlAttribute"/> to a <see cref="XmlNode"/>.
        /// </summary>
 
        ///
<param name="node">Node in which an attribute is to be added</param>
        ///
<param name="attributeName">attribute name</param>
        ///
<param name="attributeValue">value of the attribute</param>
        /// <returns>true if successful, false otherwise</returns>
        /// -------------------------------------------------------------------
        public static void AddAttribute(XmlNode node,
                                        string attributeName,
                                        string attributeValue)
        {
            node.Attributes.Append(CreateAttribute(node,
                                                    attributeName,
                                                    attributeValue));
        }
        /// -----------------------------------------------------------
        ///
<summary>
        /// Create an <see cref="XmlAttribute"/>.
        /// </summary>
 
        ///
<param name="xmlDocument">XmlDocument object</param>
        ///
<param name="attrName">name of the attribute</param>
        ///
<param name="attrValue">value of the attribute</param>
        /// <returns>an instance of an XmlAttribute object</returns>
        /// -----------------------------------------------------------
        public static XmlAttribute CreateAttribute(XmlDocument xmlDocument,
                                                    string attrName,
                                                    string attrValue)
        {
            XmlAttribute oAtt = xmlDocument.CreateAttribute(attrName);
            oAtt.Value = attrValue;
            return oAtt;
        }
 
        /// -----------------------------------------------------------
        ///
<summary>
        /// Create an <see cref="XmlAttribute"/>
        /// </summary>
 
        ///
<param name="node">Node to use for creating an attribute</param>
        ///
<param name="attrName">name of the attribute</param>
        ///
<param name="attrValue">value of the attribute</param>
        /// <returns>an instance of an XmlAttribute object</returns>
        /// -----------------------------------------------------------
        public static XmlAttribute CreateAttribute(XmlNode node,
                                                    string attrName,
                                                    string attrValue)
        {
            return (CreateAttribute(node.OwnerDocument, attrName, attrValue));
        }
        /// -----------------------------------------------------------
        ///
<summary>
        /// Adds an <see cref="XmlAttribute"/> to a <see cref="XmlNode"/>.
        /// </summary>
 
        ///
<param name="node">Node in which an attribute is to be added</param>
        ///
<param name="namespaceUri"></param>
        ///
<param name="attributeName">attribute name</param>
        ///
<param name="attributeValue">value of the attribute</param>
        /// <returns>true if successful, false otherwise</returns>
        /// -----------------------------------------------------------
        public static void AddAttribute(XmlNode node,
                                        string namespaceUri,
                                        string attributeName,
                                        string attributeValue)
        {
            XmlAttribute attribute = node.OwnerDocument.CreateAttribute(attributeName, namespaceUri);
            attribute.Value = attributeValue;
            node.Attributes.Append(attribute);
        }
    }
}