FSI.BT.IR.Tools/FSI.Lib/WinSettings/XmlSettings.cs

using System;
using System.Collections.Generic;
using System.IO;
using System.Xml;

namespace FSI.Lib.WinSettings
{

    /// <summary>
    /// The <see cref="XmlSettings"/> class makes it very easy to save your application
    /// settings to an XML file.
    /// </summary>
    /// <remarks>
    /// <para>
    /// To use the class, simply derive your own settings class from
    /// <see cref="XmlSettings" /> and add the public properties that you want to be
    /// saved as settings. You can then call the <see cref="Settings.Load"/> and
    /// <see cref="Settings.Save"/> methods to read or write those settings to an XML
    /// file.
    /// </para>
    /// <para>
    /// Your derived class' constructor should initialize your settings properties to
    /// their default values.
    /// </para>
    /// <para>
    /// Two attributes are available for public properties in your derived class. The
    /// first is <see cref="EncryptedSettingAttribute" />. Use this attribute if you
    /// want the setting to be encrypted when saved to file. When using this attribute on
    /// any property, you must provide a valid encryption password to the
    /// <see cref="XmlSettings" /> constructor.
    /// </para>
    /// <para>
    /// The second is the <see cref="ExcludedSettingAttribute"/>. Use this attribute
    /// on any properties that are used internally by your code and should not saved to
    /// file.
    /// </para>
    /// <para>
    /// All public properties without the <see cref="ExcludedSettingAttribute"></see>
    /// attribute must be of one of the supported data types. This includes all the basic
    /// data types as well as <see cref="string[]"></see> and <see cref="byte[]"></see>.
    /// All other types will raise an exception.
    /// </para>
    /// </remarks>
    /// <example>
    /// The following example creates a settings class called <c>MySettings</c> with
    /// several properties, two of which are encrypted when saved to file.
    /// <code>
    /// public class MySettings : XmlSettings
    /// {
    ///     // Define properties to be saved to file
    ///     public string EmailHost { get; set; }
    ///     public int EmailPort { get; set; }
    /// 
    ///     // The following properties will be encrypted
    ///     [EncryptedSetting]
    ///     public string UserName { get; set; }
    ///     [EncryptedSetting]
    ///     public string Password { get; set; }
    /// 
    ///     // The following property will not be saved to file
    ///     // Non-public properties are also not saved to file
    ///     [ExcludedSetting]
    ///     public DateTime Created { get; set; }
    /// 
    ///     public MySettings(string filename)
    ///         : base(filename, "Password123")
    ///     {
    ///         // Set initial, default property values
    ///         EmailHost = string.Empty;
    ///         EmailPort = 0;
    ///         UserName = string.Empty;
    ///         Password = string.Empty;
    /// 
    ///         Created = DateTime.Now;
    ///     }
    /// }
    /// </code>
    /// </example>
    /// <seealso cref="IniSettings"/>
    /// <seealso cref="RegistrySettings"/>
    public abstract class XmlSettings : Settings
    {
        /// <summary>
        /// Gets or sets the name of the XML settings file.
        /// </summary>
        [ExcludedSetting]
        public string FileName { get; set; }

        /// <summary>
        /// Constructs an instance of the <see cref="XmlSettings"></see> class.
        /// </summary>
        /// <param name="filename">Name of the settings file.</param>
        /// <param name="password">Encryption password. May be <c>null</c> if
        /// no settings use the <see cref="EncryptedSettingAttribute" />
        /// attribute.</param>
        public XmlSettings(string filename, string password = null)
            : base(password)
        {


            if (string.IsNullOrWhiteSpace(filename))
                throw new ArgumentException("A valid file name is required.", nameof(filename));
            FileName = filename;
        }

        /// <summary>
        /// Performs internal load operations.
        /// </summary>
        /// <param name="settings">Settings to be loaded.</param>
        public override void OnLoadSettings(IEnumerable<Setting> settings)
        {
            if (File.Exists(FileName))
            {
                // Load XML document
                XmlDocument doc = new XmlDocument();
                doc.Load(FileName);
                // Read settings
                foreach (Setting setting in settings)
                {
                    XmlNode node = doc.DocumentElement?.SelectSingleNode(setting.Name);
                    if (node != null)
                        setting.SetValueFromString(node.InnerText);
                }
            }
        }

        /// <summary>
        /// Performs internal save operations.
        /// </summary>
        /// <param name="settings">Settings to be saved.</param>
        public override void OnSaveSettings(IEnumerable<Setting> settings)
        {
            // Create settings document
            XmlDocument doc = new XmlDocument();
            doc.AppendChild(doc.CreateXmlDeclaration("1.0", "UTF-8", null));
            doc.AppendChild(doc.CreateElement("Settings"));
            // Write settings
            foreach (Setting setting in settings)
            {
                string value = setting.GetValueAsString();
                if (value != null)
                {
                    XmlElement element = doc.CreateElement(setting.Name);
                    element.InnerText = value;
#if NET472
                    doc.DocumentElement.AppendChild(element);
#elif NET6_0
                    doc.DocumentElement!.AppendChild(element);
#endif
                }
            }
            doc.Save(FileName);
        }
    }
}