Adds an XmlAttribute to a XmlNode

   
 

#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);
        }
    }
}