Metadata.cs

/*
 * NanoXLSX is a small .NET library to generate and read XLSX (Microsoft Excel 2007 or newer) files in an easy and native way
 * Copyright Raphael Stoeckli © 2025
 * This library is licensed under the MIT License.
 * You find a copy of the license in project folder or on: http://opensource.org/licenses/MIT
 */
 
using System;
using System.Reflection;
using NanoXLSX.Utils;
using FormatException = NanoXLSX.Exceptions.FormatException;
 
namespace NanoXLSX
{
    public class Metadata
    {
 
        #region constants
        public const string DefaultApplicationName = "NanoXLSX";
        public static string DefaultApplicationVersion { get; private set; }
        static Metadata()
        {
            Version vi = Assembly.GetExecutingAssembly().GetName().Version;
            DefaultApplicationVersion = ParseVersion(vi.Major, vi.Minor, vi.Revision, vi.Build);
        }
        #endregion
 
        #region privateFields
        private string applicationVersion;
        #endregion
 
        #region properties
        public string Application { get; set; }
        public string ApplicationVersion
        {
            get { return applicationVersion; }
            set
            {
                applicationVersion = value;
                CheckVersion();
            }
        }

        public string Category { get; set; }
        public string Company { get; set; }
        public string ContentStatus { get; set; }
        public string Creator { get; set; }
        public string Description { get; set; }
        public string HyperlinkBase { get; set; }
        public string Keywords { get; set; }
        public string Manager { get; set; }
        public string Subject { get; set; }
        public string Title { get; set; }
        #endregion
 
        #region constructors
        public Metadata()
        {
            Application = DefaultApplicationName;
            ApplicationVersion = DefaultApplicationVersion;
        }
        #endregion
 
        #region methods
        private void CheckVersion()
        {
            if (string.IsNullOrEmpty(applicationVersion))
            { return; }
            string[] split = applicationVersion.Split('.');
            bool state = true;
            if (split.Length != 2)
            { state = false; }
            else
            {
                if (split[1].Length < 1 || split[1].Length > 5)
                { state = false; }
                if (split[0].Length < 1 || split[0].Length > 5)
                { state = false; }
            }
            if (!state)
            {
                throw new FormatException("The format of the version in the metadata is wrong (" + applicationVersion + "). Should be in the format and a range from '0.0' to '99999.99999'");
            }
        }
        #endregion
 
        #region staticMethods
        public static string ParseVersion(int major, int minor, int build, int revision)
        {
            if (major < 0 || minor < 0 || build < 0 || revision < 0)
            {
                throw new FormatException("The format of the passed version is wrong. No negative number allowed.");
            }
            if (major > 99999)
            {
                throw new FormatException("The major number may not be bigger than 99999. The passed value is " + major);
            }
            string leftPart = ParserUtils.ToString(major);
            string rightPart = ParserUtils.ToString(minor) + ParserUtils.ToString(build) + ParserUtils.ToString(revision);
            rightPart = rightPart.TrimEnd('0');
            if (rightPart == "")
            { rightPart = "0"; }
            else
            {
                if (rightPart.Length > 5)
                {
                    rightPart = rightPart.Substring(0, 5);
                }
            }
            return leftPart + "." + rightPart;
        }
        #endregion
    }
}