ConfigurationElement.cs

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

using System.Collections;
using System.Collections.Specialized;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using System.Reflection;
using System.Xml;
using System.Globalization;
using System.Text;

namespace System.Configuration
{
    // Methods that are called by the configuration system, and must be overridable
    // by derived classes that wish to implement their own serialization/deserialization
    //      IsModified()
    //      ResetModified()
    //      Reset(ConfigurationElement parentSection, object context)
    //      DeserializeSection(object context, XmlNode xmlNode)
    //      SerializeSection(ConfigurationElement parentSection, object context, string name)
    public abstract class ConfigurationElement
    {
        private const string LockAttributesKey = "lockAttributes";
        private const string LockAllAttributesExceptKey = "lockAllAttributesExcept";
        private const string LockElementsKey = "lockElements";
        private const string LockAll = "*";
        private const string LockAllElementsExceptKey = "lockAllElementsExcept";
        private const string LockItemKey = "lockItem";
        internal const string DefaultCollectionPropertyName = "";

        private static readonly string[] s_lockAttributeNames =
        {
            LockAttributesKey,
            LockAllAttributesExceptKey,
            LockElementsKey,
            LockAllElementsExceptKey,
            LockItemKey,
        };

        private static readonly Hashtable s_propertyBags = new Hashtable();
        private static volatile Dictionary<Type, ConfigurationValidatorBase> s_perTypeValidators;
        internal static readonly object s_nullPropertyValue = new object();

        private static readonly ConfigurationElementProperty s_elementProperty =
            new ConfigurationElementProperty(new DefaultValidator());

        private bool _initialized;
        private bool _modified;
        private bool _readOnly;
        internal BaseConfigurationRecord _configRecord;
        private ConfigurationElementProperty _elementProperty = s_elementProperty;
        internal ContextInformation _evalContext;
        private volatile ElementInformation _evaluationElement;
        internal ConfigurationValueFlags _itemLockedFlag;
        internal ConfigurationLockCollection _lockedAllExceptAttributesList;
        internal ConfigurationLockCollection _lockedAllExceptElementsList;
        internal ConfigurationLockCollection _lockedAttributesList;
        internal ConfigurationLockCollection _lockedElementsList;

        protected ConfigurationElement()
        {
            Values = new ConfigurationValues();

            // Set the per-type validator ( this will actually have an effect only for an attributed model elements )
            // Note that in the case where the property bag fot this.GetType() has not yet been created
            // the validator for this instance will get applied in ApplyValidatorsRecursive ( see this.get_Properties )
            ApplyValidator(this);
        }

        internal static bool IsNullOrNullProperty(object value)
        {
            return value == null || value == s_nullPropertyValue;
        }

        internal bool DataToWriteInternal { get; set; }

        internal bool ElementPresent { get; set; }

        internal string ElementTagName { get; private set; }

        internal ConfigurationLockCollection LockedAttributesList => _lockedAttributesList;

        internal ConfigurationLockCollection LockedAllExceptAttributesList => _lockedAllExceptAttributesList;

        internal ConfigurationValueFlags ItemLocked => _itemLockedFlag;

        public ConfigurationLockCollection LockAttributes => _lockedAttributesList ??= new ConfigurationLockCollection(this, ConfigurationLockCollectionType.LockedAttributes);

        public ConfigurationLockCollection LockAllAttributesExcept => _lockedAllExceptAttributesList ??= new ConfigurationLockCollection(this, ConfigurationLockCollectionType.LockedExceptionList, ElementTagName);

        public ConfigurationLockCollection LockElements => _lockedElementsList ??= new ConfigurationLockCollection(this, ConfigurationLockCollectionType.LockedElements);

        public ConfigurationLockCollection LockAllElementsExcept => _lockedAllExceptElementsList ??= new ConfigurationLockCollection(this, ConfigurationLockCollectionType.LockedElementsExceptionList, ElementTagName);

        public bool LockItem
        {
            get { return (_itemLockedFlag & ConfigurationValueFlags.Locked) != 0; }
            set
            {
                if ((_itemLockedFlag & ConfigurationValueFlags.Inherited) == 0)
                {
                    _itemLockedFlag = value ? ConfigurationValueFlags.Locked : ConfigurationValueFlags.Default;
                    _itemLockedFlag |= ConfigurationValueFlags.Modified;
                }
                else
                {
                    throw new ConfigurationErrorsException(SR.Format(SR.Config_base_attribute_locked, LockItemKey));
                }
            }
        }

        protected internal object this[ConfigurationProperty prop]
        {
            get
            {
                object o = Values[prop.Name];
                if (o == null)
                {
                    if (prop.IsConfigurationElementType)
                    {
                        lock (Values.SyncRoot)
                        {
                            o = Values[prop.Name];
                            if (o == null)
                            {
                                ConfigurationElement childElement = CreateElement(prop.Type);

                                if (_readOnly) childElement.SetReadOnly();

                                if (typeof(ConfigurationElementCollection).IsAssignableFrom(prop.Type))
                                {
                                    ConfigurationElementCollection childElementCollection =
                                        childElement as ConfigurationElementCollection;
                                    if (prop.AddElementName != null)
                                        childElementCollection.AddElementName = prop.AddElementName;
                                    if (prop.RemoveElementName != null)
                                        childElementCollection.RemoveElementName = prop.RemoveElementName;
                                    if (prop.ClearElementName != null)
                                        childElementCollection.ClearElementName = prop.ClearElementName;
                                }

                                //_values[prop.Name] = childElement;
                                Values.SetValue(prop.Name, childElement, ConfigurationValueFlags.Inherited, null);
                                o = childElement;
                            }
                        }
                    }
                    else o = prop.DefaultValue;
                }
                else
                {
                    if (o == s_nullPropertyValue) o = null;
                }

                // If its an invalid value - throw the error now
                if (o is InvalidPropValue) throw ((InvalidPropValue)o).Error;

                return o;
            }
            set
            {
                SetPropertyValue(prop, value, false); // Do not ignore locks!!!
            }
        }

        protected internal object this[string propertyName]
        {
            get
            {
                ConfigurationProperty prop = Properties[propertyName];
                if (prop == null)
                {
                    prop = Properties[DefaultCollectionPropertyName];
                    if (prop.ProvidedName != propertyName) return null;
                }
                return this[prop];
            }
            set
            {
                Debug.Assert(Properties.Contains(propertyName), "Properties.Contains(propertyName)");
                SetPropertyValue(Properties[propertyName], value, false); // Do not ignore locks!!!
            }
        }

        protected internal virtual ConfigurationPropertyCollection Properties
        {
            get
            {
                ConfigurationPropertyCollection result;

                if (PropertiesFromType(GetType(), out result))
                    ApplyValidatorsRecursive(this);

                return result;
            }
        }

        internal ConfigurationValues Values { get; }

        public ElementInformation ElementInformation => _evaluationElement ??= new ElementInformation(this);

        protected ContextInformation EvaluationContext
        {
            get
            {
                if (_evalContext == null)
                {
                    if (_configRecord == null)
                    {
                        // This is not associated with a context, so throw failure
                        throw new ConfigurationErrorsException(SR.Config_element_no_context);
                    }

                    _evalContext = new ContextInformation(_configRecord);
                }

                return _evalContext;
            }
        }

        protected internal virtual ConfigurationElementProperty ElementProperty => _elementProperty;

        protected bool HasContext => _configRecord != null;

        public Configuration CurrentConfiguration => _configRecord?.CurrentConfiguration;

        internal static ConfigurationElement CreateElement(Type type)
        {
            ConfigurationElement element = (ConfigurationElement)TypeUtil.CreateInstance(type);
            element.CallInit();
            return element;
        }

        protected internal virtual void Init()
        {
            // If Init is called by the derived class, we may be able
            // to set _bInited to true if the derived class properly
            // calls Init on its base.
            _initialized = true;
        }

        internal void CallInit()
        {
            // Ensure Init is called just once
            if (!_initialized)
            {
                Init();
                _initialized = true;
            }
        }

        internal void MergeLocks(ConfigurationElement source)
        {
            if (source == null) return;

            _itemLockedFlag = (source._itemLockedFlag & ConfigurationValueFlags.Locked) != 0
                ? ConfigurationValueFlags.Inherited | source._itemLockedFlag
                : _itemLockedFlag;

            if (source._lockedAttributesList != null)
            {
                // Mark entry as from the parent - read only
                _lockedAttributesList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedAttributes);

                foreach (string key in source._lockedAttributesList)
                    _lockedAttributesList.Add(key, ConfigurationValueFlags.Inherited);
            }

            if (source._lockedAllExceptAttributesList != null)
            {
                _lockedAllExceptAttributesList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedExceptionList, string.Empty,
                    source._lockedAllExceptAttributesList);

                StringCollection intersectionCollection = IntersectLockCollections(_lockedAllExceptAttributesList,
                    source._lockedAllExceptAttributesList);

                _lockedAllExceptAttributesList.ClearInternal(false);
                foreach (string key in intersectionCollection)
                    _lockedAllExceptAttributesList.Add(key, ConfigurationValueFlags.Default);
            }

            if (source._lockedElementsList != null)
            {
                _lockedElementsList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedElements);

                ConfigurationElementCollection collection = null;
                if (Properties.DefaultCollectionProperty != null)
                {
                    // this is not a collection but it may contain a default collection
                    collection = this[Properties.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if (collection != null)
                    {
                        // Default collections don't know their tag name
                        collection.InternalElementTagName = source.ElementTagName;
                        //point to the same instance of the collection from parent
                        collection._lockedElementsList ??= _lockedElementsList;
                    }
                }

                foreach (string key in source._lockedElementsList)
                {
                    // Mark entry as from the parent - read only
                    _lockedElementsList.Add(key, ConfigurationValueFlags.Inherited);
                    // add the local copy
                    collection?._lockedElementsList.Add(key, ConfigurationValueFlags.Inherited);
                }
            }

            if (source._lockedAllExceptElementsList != null)
            {
                if ((_lockedAllExceptElementsList == null) || (_lockedAllExceptElementsList.Count == 0))
                {
                    _lockedAllExceptElementsList = new ConfigurationLockCollection(this,
                        ConfigurationLockCollectionType.LockedElementsExceptionList, source.ElementTagName,
                        source._lockedAllExceptElementsList);
                }

                StringCollection intersectionCollection = IntersectLockCollections(_lockedAllExceptElementsList,
                    source._lockedAllExceptElementsList);

                if (Properties.DefaultCollectionProperty != null)
                {
                    // this is not a collection but it may contain a default collection
                    ConfigurationElementCollection collection = this[Properties.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if ((collection != null) && (collection._lockedAllExceptElementsList == null))
                    {
                        // point default collection to the parent collection
                        collection._lockedAllExceptElementsList = _lockedAllExceptElementsList;
                    }
                }

                _lockedAllExceptElementsList.ClearInternal(false);
                foreach (string key in intersectionCollection)
                    if (!_lockedAllExceptElementsList.Contains(key) || (key == ElementTagName))
                        _lockedAllExceptElementsList.Add(key, ConfigurationValueFlags.Default);

                if (_lockedAllExceptElementsList.HasParentElements)
                {
                    // add the local copy
                    foreach (ConfigurationProperty prop in Properties)
                        if (!_lockedAllExceptElementsList.Contains(prop.Name) &&
                                prop.IsConfigurationElementType)
                            ((ConfigurationElement)this[prop]).SetLocked();
                }
            }
        }

        internal void HandleLockedAttributes(ConfigurationElement source)
        {
            // if there are locked attributes on this collection element
            if (source == null || (source._lockedAttributesList == null && source._lockedAllExceptAttributesList == null)) return;

            // enumerate the possible locked properties
            foreach (PropertyInformation propInfo in source.ElementInformation.Properties)
                if (((source._lockedAttributesList != null) &&
                    (source._lockedAttributesList.Contains(propInfo.Name) ||
                    source._lockedAttributesList.Contains(LockAll))) ||
                    ((source._lockedAllExceptAttributesList != null) &&
                    !source._lockedAllExceptAttributesList.Contains(propInfo.Name))
                    )
                {
                    if ((propInfo.Name == LockAttributesKey) || (propInfo.Name == LockAllAttributesExceptKey)) continue;

                    // if the attribute has been locked in the source then check to see
                    // if the local config is trying to override it
                    if (ElementInformation.Properties[propInfo.Name] == null)
                    {
                        // locked items are not defined

                        ConfigurationPropertyCollection props = Properties;
                        // so create the property based in the source item
                        ConfigurationProperty prop =
                            source.Properties[propInfo.Name];
                        props.Add(prop); // Add the property information to the property bag
                        _evaluationElement = null; // flush the cached element data

                        // Add the data from the source element but mark it as in herited
                        // This must use setvalue in order to set the lock and inherited flags
                        ConfigurationValueFlags flags = ConfigurationValueFlags.Inherited |
                            ConfigurationValueFlags.Locked;
                        Values.SetValue(propInfo.Name, propInfo.Value, flags,
                            source.PropertyInfoInternal(propInfo.Name));
                    }
                    else
                    {
                        // don't error when optional attribute are not defined yet
                        if (ElementInformation.Properties[propInfo.Name].ValueOrigin ==
                            PropertyValueOrigin.SetHere)
                        {
                            // Don't allow the override
                            throw new ConfigurationErrorsException(
                                SR.Format(SR.Config_base_attribute_locked, propInfo.Name));
                        }

                        // They did not override so we need to make sure the value comes from the locked one
                        ElementInformation.Properties[propInfo.Name].Value = propInfo.Value;
                    }
                }
        }

        internal virtual void AssociateContext(BaseConfigurationRecord configRecord)
        {
            _configRecord = configRecord;
            Values.AssociateContext(configRecord);
        }

        protected internal virtual bool IsModified()
        {
            if (_modified
                || ((_lockedAttributesList != null) && _lockedAttributesList.IsModified)
                || ((_lockedAllExceptAttributesList != null) && _lockedAllExceptAttributesList.IsModified)
                || ((_lockedElementsList != null) && _lockedElementsList.IsModified)
                || ((_lockedAllExceptElementsList != null) && _lockedAllExceptElementsList.IsModified)
                || ((_itemLockedFlag & ConfigurationValueFlags.Modified) != 0))
                return true;

            foreach (ConfigurationElement elem in Values.ConfigurationElements)
                if (elem.IsModified()) return true;

            return false;
        }

        protected internal virtual void ResetModified()
        {
            _modified = false;
            _lockedAttributesList?.ResetModified();
            _lockedAllExceptAttributesList?.ResetModified();
            _lockedElementsList?.ResetModified();
            _lockedAllExceptElementsList?.ResetModified();
            foreach (ConfigurationElement elem in Values.ConfigurationElements)
                elem.ResetModified();
        }

        public virtual bool IsReadOnly()
        {
            return _readOnly;
        }

        protected internal virtual void SetReadOnly()
        {
            _readOnly = true;
            foreach (ConfigurationElement elem in Values.ConfigurationElements) elem.SetReadOnly();
        }

        internal void SetLocked()
        {
            _itemLockedFlag = ConfigurationValueFlags.Locked | ConfigurationValueFlags.XmlParentInherited;

            foreach (ConfigurationProperty prop in Properties)
            {
                ConfigurationElement elem = this[prop] as ConfigurationElement;
                if (elem != null)
                {
                    if (elem.GetType() != GetType()) elem.SetLocked();

                    ConfigurationElementCollection collection = this[prop] as ConfigurationElementCollection;
                    if (collection != null)
                    {
                        foreach (object obj in collection)
                        {
                            ConfigurationElement element = obj as ConfigurationElement;
                            element?.SetLocked();
                        }
                    }
                }
            }
        }

        internal ArrayList GetErrorsList()
        {
            ArrayList errorList = new ArrayList();

            ListErrors(errorList);

            return errorList;
        }

        internal ConfigurationErrorsException GetErrors()
        {
            ArrayList errorsList = GetErrorsList();

            if (errorsList.Count == 0) return null;

            ConfigurationErrorsException e = new ConfigurationErrorsException(errorsList);
            return e;
        }

        protected virtual void ListErrors(IList errorList)
        {
            // First list errors in this element, then in subelements
            foreach (InvalidPropValue invalidValue in Values.InvalidValues) errorList.Add(invalidValue.Error);

            foreach (ConfigurationElement elem in Values.ConfigurationElements)
            {
                elem.ListErrors(errorList);
                ConfigurationElementCollection collection = elem as ConfigurationElementCollection;
                if (collection != null) foreach (ConfigurationElement item in collection) item.ListErrors(errorList);
            }
        }

        protected internal virtual void InitializeDefault() { }

        internal void CheckLockedElement(string elementName, XmlReader reader)
        {
            // have to check if clear was locked!
            if (elementName != null)
            {
                bool lockedInParent = (_lockedElementsList != null) &&
                    (_lockedElementsList.DefinedInParent(LockAll) || _lockedElementsList.DefinedInParent(elementName));

                if (lockedInParent ||
                    ((_lockedAllExceptElementsList != null) && (_lockedAllExceptElementsList.Count != 0) &&
                    _lockedAllExceptElementsList.HasParentElements &&
                    !_lockedAllExceptElementsList.DefinedInParent(elementName)) ||
                    ((_itemLockedFlag & ConfigurationValueFlags.Inherited) != 0)
                    )
                {
                    throw new ConfigurationErrorsException(SR.Format(SR.Config_base_element_locked, elementName),
                        reader);
                }
            }
        }

        internal void RemoveAllInheritedLocks()
        {
            _lockedAttributesList?.RemoveInheritedLocks();
            _lockedElementsList?.RemoveInheritedLocks();
            _lockedAllExceptAttributesList?.RemoveInheritedLocks();
            _lockedAllExceptElementsList?.RemoveInheritedLocks();
        }

        internal void ResetLockLists(ConfigurationElement parentElement)
        {
            _lockedAttributesList = null;
            _lockedAllExceptAttributesList = null;
            _lockedElementsList = null;
            _lockedAllExceptElementsList = null;

            if (parentElement == null) return;

            _itemLockedFlag = (parentElement._itemLockedFlag & ConfigurationValueFlags.Locked) != 0
                ? ConfigurationValueFlags.Inherited | parentElement._itemLockedFlag
                : ConfigurationValueFlags.Default;

            if (parentElement._lockedAttributesList != null)
            {
                // Mark entry as from the parent - read only
                _lockedAttributesList = new ConfigurationLockCollection(this,
                ConfigurationLockCollectionType.LockedAttributes);
                foreach (string key in parentElement._lockedAttributesList)
                    _lockedAttributesList.Add(key, ConfigurationValueFlags.Inherited);
            }

            if (parentElement._lockedAllExceptAttributesList != null)
            {
                _lockedAllExceptAttributesList = new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedExceptionList, string.Empty,
                    parentElement._lockedAllExceptAttributesList);
            }

            if (parentElement._lockedElementsList != null)
            {
                _lockedElementsList = new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedElements);

                if (Properties.DefaultCollectionProperty != null)
                {
                    // this is not a collection but it may contain a default collection
                    ConfigurationElementCollection collection = this[Properties.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if (collection != null)
                    {
                        collection.InternalElementTagName = parentElement.ElementTagName;
                        // Default collections don't know there tag name
                        collection._lockedElementsList ??= _lockedElementsList;
                    }
                }

                // Mark entry as from the parent - read only
                foreach (string key in parentElement._lockedElementsList)
                    _lockedElementsList.Add(key, ConfigurationValueFlags.Inherited);
            }

            if (parentElement._lockedAllExceptElementsList != null)
            {
                _lockedAllExceptElementsList = new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedElementsExceptionList, parentElement.ElementTagName,
                    parentElement._lockedAllExceptElementsList);

                if (Properties.DefaultCollectionProperty != null)
                {
                    // this is not a collection but it may contain a default collection
                    ConfigurationElementCollection collection = this[Properties.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if ((collection != null) && (collection._lockedAllExceptElementsList == null))
                        collection._lockedAllExceptElementsList = _lockedAllExceptElementsList;
                }
            }
        }

        protected internal virtual void Reset(ConfigurationElement parentElement)
        {
            Values.Clear();
            ResetLockLists(parentElement);
            ConfigurationPropertyCollection props = Properties; // Force the bag to be up to date
            ElementPresent = false;
            if (parentElement == null) InitializeDefault();
            else
            {
                bool hasAnyChildElements = false;

                ConfigurationPropertyCollection collectionKeys = null;

                for (int index = 0; index < parentElement.Values.Count; index++)
                {
                    string key = parentElement.Values.GetKey(index);
                    ConfigurationValue configValue = parentElement.Values.GetConfigValue(index);
                    object value = configValue?.Value;
                    PropertySourceInfo sourceInfo = configValue?.SourceInfo;

                    ConfigurationProperty prop = parentElement.Properties[key];
                    if ((prop == null) || ((collectionKeys != null) && !collectionKeys.Contains(prop.Name))) continue;

                    if (prop.IsConfigurationElementType) hasAnyChildElements = true;
                    else
                    {
                        ConfigurationValueFlags flags = ConfigurationValueFlags.Inherited |
                            (((_lockedAttributesList != null) &&
                            (_lockedAttributesList.Contains(key) ||
                            _lockedAttributesList.Contains(LockAll))) ||
                            ((_lockedAllExceptAttributesList != null) &&
                            !_lockedAllExceptAttributesList.Contains(key))
                                ? ConfigurationValueFlags.Locked
                                : ConfigurationValueFlags.Default);

                        if (value != s_nullPropertyValue)
                        {
                            // _values[key] = value;
                            Values.SetValue(key, value, flags, sourceInfo);
                        }

                        if (!props.Contains(key)) // this is for optional provider models keys
                        {
                            props.Add(prop);
                            Values.SetValue(key, value, flags, sourceInfo);
                        }
                    }
                }

                if (hasAnyChildElements)
                {
                    for (int index = 0; index < parentElement.Values.Count; index++)
                    {
                        string key = parentElement.Values.GetKey(index);
                        object value = parentElement.Values[index];

                        ConfigurationProperty prop = parentElement.Properties[key];
                        if ((prop != null) && prop.IsConfigurationElementType)
                        {
                            //((ConfigurationElement)value).SerializeToXmlElement(writer, prop.Name);
                            ConfigurationElement childElement = (ConfigurationElement)this[prop];
                            childElement.Reset((ConfigurationElement)value);
                        }
                    }
                }
            }
        }

        public override bool Equals(object compareTo)
        {
            ConfigurationElement otherElement = compareTo as ConfigurationElement;

            if ((otherElement == null) ||
                (compareTo.GetType() != GetType()) ||
                (otherElement.Properties.Count != Properties.Count))
                return false;

            foreach (ConfigurationProperty configProperty in Properties)
            {
                object thisValue = Values[configProperty.Name];
                object otherValue = otherElement.Values[configProperty.Name];

                if (!Equals(thisValue, otherValue))
                {
                    // The values don't match- if either is 'null' default is ok
                    if (!((IsNullOrNullProperty(thisValue) && Equals(otherValue, configProperty.DefaultValue))
                        || (IsNullOrNullProperty(otherValue) && Equals(thisValue, configProperty.DefaultValue))))
                        return false;
                }
            }

            return true;
        }

        public override int GetHashCode()
        {
            int hHashCode = 0;
            foreach (ConfigurationProperty configProperty in Properties)
            {
                object o = this[configProperty];
                if (o != null) hHashCode ^= this[configProperty].GetHashCode();
            }
            return hHashCode;
        }

        private static bool PropertiesFromType(Type type, out ConfigurationPropertyCollection result)
        {
            ConfigurationPropertyCollection properties = (ConfigurationPropertyCollection)s_propertyBags[type];
            bool firstTimeInit = false;
            if (properties == null)
            {
                lock (s_propertyBags.SyncRoot)
                {
                    properties = (ConfigurationPropertyCollection)s_propertyBags[type];
                    if (properties == null)
                    {
                        properties = CreatePropertyBagFromType(type);
                        s_propertyBags[type] = properties;
                        firstTimeInit = true;
                    }
                }
            }
            result = properties;
            return firstTimeInit;
        }

        private static ConfigurationPropertyCollection CreatePropertyBagFromType(Type type)
        {
            Debug.Assert(type != null, "type != null");

            // For ConfigurationElement derived classes - get the per-type validator
            if (typeof(ConfigurationElement).IsAssignableFrom(type))
            {
                ConfigurationValidatorAttribute validatorAttribute =
                    Attribute.GetCustomAttribute(type, typeof(ConfigurationValidatorAttribute)) as
                        ConfigurationValidatorAttribute;

                if (validatorAttribute != null)
                {
                    validatorAttribute.SetDeclaringType(type);
                    ConfigurationValidatorBase validator = validatorAttribute.ValidatorInstance;
                    if (validator != null) CachePerTypeValidator(type, validator);
                }
            }

            ConfigurationPropertyCollection properties = new ConfigurationPropertyCollection();

            foreach (PropertyInfo propertyInformation in type.GetProperties(BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance))
            {
                ConfigurationProperty property = CreateConfigurationPropertyFromAttributes(propertyInformation);
                if (property != null) properties.Add(property);
            }

            return properties;
        }

        private static ConfigurationProperty CreateConfigurationPropertyFromAttributes(PropertyInfo propertyInformation)
        {
            Debug.Assert(propertyInformation != null, "propertyInformation != null");

            ConfigurationProperty result = null;

            ConfigurationPropertyAttribute attribProperty =
                Attribute.GetCustomAttribute(propertyInformation,
                    typeof(ConfigurationPropertyAttribute)) as ConfigurationPropertyAttribute;

            // If there is no ConfigurationPropertyAttribute - this is not considered a property
            if (attribProperty != null)
                result = new ConfigurationProperty(propertyInformation);

            // Handle some special cases of property types
            if ((result != null) && typeof(ConfigurationElement).IsAssignableFrom(result.Type))
            {
                PropertiesFromType(result.Type, out _);
            }

            return result;
        }

        private static void CachePerTypeValidator(Type type, ConfigurationValidatorBase validator)
        {
            Debug.Assert((type != null) && (validator != null));
            Debug.Assert(typeof(ConfigurationElement).IsAssignableFrom(type));

            // Use the same lock as the property bag lock since in the current implementation
            // the only way to get to this method is through the code path that locks the property bag cache first ( see PropertiesFromType() )

            // NOTE[ Thread Safety ]: Non-guarded access to static variable - since this code is called only from CreatePropertyBagFromType
            // which in turn is done onle once per type and is guarded by the s_propertyBag.SyncRoot then this call is thread safe as well
            s_perTypeValidators ??= new Dictionary<Type, ConfigurationValidatorBase>();

            // A type validator should be cached only once. If it isn't then attribute parsing is done more then once which should be avoided
            Debug.Assert(!s_perTypeValidators.ContainsKey(type));

            // Make sure the supplied validator supports validating this object
            if (!validator.CanValidate(type))
            {
                throw new ConfigurationErrorsException(
                    SR.Format(SR.Validator_does_not_support_elem_type, type.Name));
            }

            s_perTypeValidators.Add(type, validator);
        }

        private static void ApplyValidatorsRecursive(ConfigurationElement root)
        {
            Debug.Assert(root != null);

            // Apply the validator on 'root'
            ApplyValidator(root);

            // Apply validators on created child elements (non created ones will get their validators run when constructed)
            foreach (ConfigurationElement elem in root.Values.ConfigurationElements) ApplyValidatorsRecursive(elem);
        }

        private static void ApplyValidator(ConfigurationElement elem)
        {
            Debug.Assert(elem != null);

            if ((s_perTypeValidators != null) && s_perTypeValidators.TryGetValue(elem.GetType(), out ConfigurationValidatorBase value))
                elem._elementProperty = new ConfigurationElementProperty(value);
        }

        protected void SetPropertyValue(ConfigurationProperty prop, object value, bool ignoreLocks)
        {
            if (IsReadOnly()) throw new ConfigurationErrorsException(SR.Config_base_read_only);

            if ((ignoreLocks == false) &&
                (((_lockedAllExceptAttributesList != null) && _lockedAllExceptAttributesList.HasParentElements &&
                !_lockedAllExceptAttributesList.DefinedInParent(prop.Name)) ||
                ((_lockedAttributesList != null) &&
                (_lockedAttributesList.DefinedInParent(prop.Name) || _lockedAttributesList.DefinedInParent(LockAll))) ||
                (((_itemLockedFlag & ConfigurationValueFlags.Locked) != 0) &&
                ((_itemLockedFlag & ConfigurationValueFlags.Inherited) != 0))))
                throw new ConfigurationErrorsException(SR.Format(SR.Config_base_attribute_locked, prop.Name));

            _modified = true;

            // Run the new value through the validator to make sure its ok to store it
            if (value != null) prop.Validate(value);

            Values[prop.Name] = value ?? s_nullPropertyValue;
        }

        internal PropertySourceInfo PropertyInfoInternal(string propertyName)
        {
            return Values.GetSourceInfo(propertyName);
        }

        internal string PropertyFileName(string propertyName)
        {
            // Get the filename of the parent if prop is not there
            PropertySourceInfo p = PropertyInfoInternal(propertyName) ?? PropertyInfoInternal(string.Empty);
            return p == null ? string.Empty : p.FileName;
        }

        internal int PropertyLineNumber(string propertyName)
        {
            PropertySourceInfo p = PropertyInfoInternal(propertyName) ?? PropertyInfoInternal(string.Empty);
            return p?.LineNumber ?? 0;
        }

        internal virtual void Dump(TextWriter tw)
        {
            tw.WriteLine("Type: " + GetType().FullName);

            foreach (PropertyInfo pi in GetType().GetProperties())
                tw.WriteLine("{0}: {1}", pi.Name, pi.GetValue(this, null));
        }

        protected internal virtual void Unmerge(ConfigurationElement sourceElement,
            ConfigurationElement parentElement,
            ConfigurationSaveMode saveMode)
        {
            if (sourceElement == null) return;
            bool hasAnyChildElements = false;

            _lockedAllExceptAttributesList = sourceElement._lockedAllExceptAttributesList;
            _lockedAllExceptElementsList = sourceElement._lockedAllExceptElementsList;
            _itemLockedFlag = sourceElement._itemLockedFlag;
            _lockedAttributesList = sourceElement._lockedAttributesList;
            _lockedElementsList = sourceElement._lockedElementsList;
            AssociateContext(sourceElement._configRecord);

            if (parentElement != null)
            {
                if (parentElement._lockedAttributesList != null)
                {
                    _lockedAttributesList = UnMergeLockList(sourceElement._lockedAttributesList,
                        parentElement._lockedAttributesList, saveMode);
                }
                if (parentElement._lockedElementsList != null)
                {
                    _lockedElementsList = UnMergeLockList(sourceElement._lockedElementsList,
                        parentElement._lockedElementsList, saveMode);
                }
                if (parentElement._lockedAllExceptAttributesList != null)
                {
                    _lockedAllExceptAttributesList = UnMergeLockList(sourceElement._lockedAllExceptAttributesList,
                        parentElement._lockedAllExceptAttributesList, saveMode);
                }
                if (parentElement._lockedAllExceptElementsList != null)
                {
                    _lockedAllExceptElementsList = UnMergeLockList(sourceElement._lockedAllExceptElementsList,
                        parentElement._lockedAllExceptElementsList, saveMode);
                }
            }

            ConfigurationPropertyCollection props = Properties;
            ConfigurationPropertyCollection collectionKeys = null;

            // check for props not in bag from source
            for (int index = 0; index < sourceElement.Values.Count; index++)
            {
                string key = sourceElement.Values.GetKey(index);
                object value = sourceElement.Values[index];
                ConfigurationProperty prop = sourceElement.Properties[key];
                if ((prop == null) || ((collectionKeys != null) && !collectionKeys.Contains(prop.Name)))
                    continue;

                if (prop.IsConfigurationElementType)
                {
                    hasAnyChildElements = true;
                }
                else if (value != s_nullPropertyValue && !props.Contains(key))
                {
                    // this is for optional provider models keys
                    // _values[key] = value;
                    ConfigurationValueFlags valueFlags = sourceElement.Values.RetrieveFlags(key);
                    Values.SetValue(key, value, valueFlags, null);

                    props.Add(prop);
                }
            }

            foreach (ConfigurationProperty prop in Properties)
            {
                if ((prop == null) || ((collectionKeys != null) && !collectionKeys.Contains(prop.Name))) continue;
                if (prop.IsConfigurationElementType) hasAnyChildElements = true;
                else
                {
                    object value = sourceElement.Values[prop.Name];

                    // if the property is required or we are writing a full config make sure we have defaults
                    if ((prop.IsRequired || (saveMode == ConfigurationSaveMode.Full)) && IsNullOrNullProperty(value))
                    {
                        // If the default value is null, this means there wasnt a reasonable default for the value
                        // and there is nothing more we can do. Otherwise reset the value to the default

                        // Note: 'null' should be used as default for non-empty strings instead
                        // of the current practice to use String.Epmty
                        if (prop.DefaultValue != null)
                            value = prop.DefaultValue; // need to make sure required properties are persisted
                    }

                    if (IsNullOrNullProperty(value)) continue;

                    // Use the parent value if available
                    object value2 = parentElement?.Values[prop.Name] ?? prop.DefaultValue;

                    // If changed and not same as parent write or required
                    switch (saveMode)
                    {
                        case ConfigurationSaveMode.Minimal:
                            if (!Equals(value, value2) || prop.IsRequired)
                                Values[prop.Name] = value;
                            break;
                        case ConfigurationSaveMode.Modified:
                            bool modified = sourceElement.Values.IsModified(prop.Name);
                            bool inherited = sourceElement.Values.IsInherited(prop.Name);

                            // update the value if the property is required, modified or it was not inherited
                            // Also update properties that ARE inherited when we are resetting the object
                            // as long as the property is not the same as the default value for the property
                            if (prop.IsRequired || modified || !inherited ||
                                ((parentElement == null) && inherited && !Equals(value, value2)))
                                Values[prop.Name] = value;
                            break;
                        case ConfigurationSaveMode.Full:
                            if (IsNullOrNullProperty(value))
                                Values[prop.Name] = value2;
                            else
                                Values[prop.Name] = value;
                            break;
                    }
                }
            }

            if (hasAnyChildElements)
            {
                foreach (ConfigurationProperty prop in Properties)
                    if (prop.IsConfigurationElementType)
                    {
                        ConfigurationElement pElem =
                            (ConfigurationElement)parentElement?[prop];
                        ConfigurationElement childElement = (ConfigurationElement)this[prop];
                        if ((ConfigurationElement)sourceElement[prop] != null)
                        {
                            childElement.Unmerge((ConfigurationElement)sourceElement[prop],
                                pElem, saveMode);
                        }
                    }
            }
        }

        protected internal virtual bool SerializeToXmlElement(XmlWriter writer, string elementName)
        {
            if ((_configRecord != null) && (_configRecord.TargetFramework != null))
            {
                ConfigurationSection section = null;
                if (_configRecord.SectionsStack.Count > 0)
                    section = _configRecord.SectionsStack.Peek() as ConfigurationSection;
                if ((section != null) &&
                    !section.ShouldSerializeElementInTargetVersion(this, elementName, _configRecord.TargetFramework))
                    return false;
            }

            bool dataToWrite = DataToWriteInternal;

            //  Don't write elements that are locked in the parent
            if (((_lockedElementsList != null) && _lockedElementsList.DefinedInParent(elementName)) ||
                ((_lockedAllExceptElementsList != null) && _lockedAllExceptElementsList.HasParentElements &&
                !_lockedAllExceptElementsList.DefinedInParent(elementName)))
                return dataToWrite;

            if (SerializeElement(null, false)) // check if there is anything to write...
            {
                writer?.WriteStartElement(elementName);
                dataToWrite |= SerializeElement(writer, false);
                writer?.WriteEndElement();
            }
            return dataToWrite;
        }

        protected internal virtual bool SerializeElement(XmlWriter writer, bool serializeCollectionKey)
        {
            PreSerialize(writer);

            bool dataToWrite = DataToWriteInternal;
            bool hasAnyChildElements = false;
            bool foundDefaultElement = false;
            ConfigurationPropertyCollection props = Properties;
            ConfigurationPropertyCollection collectionKeys = null;

            for (int index = 0; index < Values.Count; index++)
            {
                string key = Values.GetKey(index);
                object value = Values[index];

                ConfigurationProperty prop = props[key];
                if ((prop == null) || ((collectionKeys != null) && !collectionKeys.Contains(prop.Name))) continue;

                if (prop.IsVersionCheckRequired && (_configRecord != null) && (_configRecord.TargetFramework != null))
                {
                    ConfigurationSection section = null;
                    if (_configRecord.SectionsStack.Count > 0)
                        section = _configRecord.SectionsStack.Peek() as ConfigurationSection;

                    if ((section != null) &&
                        !section.ShouldSerializePropertyInTargetVersion(prop, prop.Name, _configRecord.TargetFramework,
                            this))
                        continue;
                }


                if (prop.IsConfigurationElementType)
                {
                    hasAnyChildElements = true;
                }
                else
                {
                    if (((_lockedAllExceptAttributesList != null) && _lockedAllExceptAttributesList.HasParentElements &&
                        !_lockedAllExceptAttributesList.DefinedInParent(prop.Name)) ||
                        ((_lockedAttributesList != null) && _lockedAttributesList.DefinedInParent(prop.Name)))
                    {
                        if (prop.IsRequired)
                        {
                            throw new ConfigurationErrorsException(SR.Format(
                                SR.Config_base_required_attribute_locked, prop.Name));
                        }
                        value = s_nullPropertyValue;
                    }

                    if (value == s_nullPropertyValue || (serializeCollectionKey && !prop.IsKey)) continue;

                    string xmlValue;

                    // If this was an invalid string value and was cached - write it out as is
                    if (value is InvalidPropValue) xmlValue = ((InvalidPropValue)value).Value;
                    else
                    {
                        prop.Validate(value);
                        xmlValue = prop.ConvertToString(value);
                    }

                    if ((xmlValue != null) && (writer != null))
                    {
                        if (prop.IsTypeStringTransformationRequired)
                            xmlValue = GetTransformedTypeString(xmlValue);
                        if (prop.IsAssemblyStringTransformationRequired)
                            xmlValue = GetTransformedAssemblyString(xmlValue);

                        writer.WriteAttributeString(prop.Name, xmlValue);
                    }

                    dataToWrite = dataToWrite || (xmlValue != null);
                }
            }

            if (serializeCollectionKey == false)
            {
                dataToWrite |= SerializeLockList(_lockedAttributesList, LockAttributesKey, writer);
                dataToWrite |= SerializeLockList(_lockedAllExceptAttributesList, LockAllAttributesExceptKey, writer);
                dataToWrite |= SerializeLockList(_lockedElementsList, LockElementsKey, writer);
                dataToWrite |= SerializeLockList(_lockedAllExceptElementsList, LockAllElementsExceptKey, writer);
                if (((_itemLockedFlag & ConfigurationValueFlags.Locked) != 0) &&
                    ((_itemLockedFlag & ConfigurationValueFlags.Inherited) == 0) &&
                    ((_itemLockedFlag & ConfigurationValueFlags.XmlParentInherited) == 0))
                {
                    dataToWrite = true;
                    writer?.WriteAttributeString(LockItemKey, true.ToString().ToLowerInvariant());
                }
            }

            if (hasAnyChildElements)
            {
                for (int index = 0; index < Values.Count; index++)
                {
                    string key = Values.GetKey(index);
                    object value = Values[index];

                    ConfigurationProperty prop = props[key];

                    // if we are writing a remove and the sub element is not part of the key don't write it.
                    if ((serializeCollectionKey && !prop.IsKey) || !(value is ConfigurationElement))
                        continue;

                    if (((_lockedElementsList != null) && _lockedElementsList.DefinedInParent(key)) ||
                        ((_lockedAllExceptElementsList != null) &&
                        _lockedAllExceptElementsList.HasParentElements &&
                        !_lockedAllExceptElementsList.DefinedInParent(key)))
                        continue;

                    ConfigurationElement elem = (ConfigurationElement)value;

                    if (prop.Name != ConfigurationProperty.DefaultCollectionPropertyName)
                    {
                        dataToWrite |= elem.SerializeToXmlElement(writer, prop.Name);
                    }
                    else
                    {
                        if (!foundDefaultElement)
                        {
                            // Prevent the locks from serializing a second time since locks
                            // on a default collection serialize with their parent node
                            elem._lockedAttributesList = null;
                            elem._lockedAllExceptAttributesList = null;
                            elem._lockedElementsList = null;
                            elem._lockedAllExceptElementsList = null;

                            dataToWrite |= elem.SerializeElement(writer, false);

                            foundDefaultElement = true;
                        }
                        else
                        {
                            throw new ConfigurationErrorsException(
                                SR.Format(SR.Config_base_element_cannot_have_multiple_child_elements, prop.Name));
                        }
                    }
                }
            }

            return dataToWrite;
        }

        private static bool SerializeLockList(ConfigurationLockCollection list, string elementKey, XmlWriter writer)
        {
            StringBuilder sb = new StringBuilder();

            if (list != null)
            {
                foreach (string key in list)
                    if (!list.DefinedInParent(key))
                    {
                        if (sb.Length != 0)
                            sb.Append(',');
                        sb.Append(key);
                    }
            }

            if ((writer != null) && (sb.Length != 0))
                writer.WriteAttributeString(elementKey, sb.ToString());
            return sb.Length != 0;
        }

        internal void ReportInvalidLock(string attribToLockTrim, ConfigurationLockCollectionType lockedType,
            ConfigurationValue value, string collectionProperties)
        {
            StringBuilder sb = new StringBuilder();

            // Add the collection properties when locking elements
            if (!string.IsNullOrEmpty(collectionProperties) &&
                ((lockedType == ConfigurationLockCollectionType.LockedElements) ||
                (lockedType == ConfigurationLockCollectionType.LockedElementsExceptionList)))
            {
                if (sb.Length != 0)
                    sb.Append(',');
                sb.Append(collectionProperties);
            }

            // construct a list of valid lockable properties
            foreach (object prop in Properties)
            {
                ConfigurationProperty validProp = (ConfigurationProperty)prop;
                if ((validProp.Name != LockAttributesKey) &&
                    (validProp.Name != LockAllAttributesExceptKey) &&
                    (validProp.Name != LockElementsKey) &&
                    (validProp.Name != LockAllElementsExceptKey)
                    )
                {
                    if ((lockedType == ConfigurationLockCollectionType.LockedElements) ||
                        (lockedType == ConfigurationLockCollectionType.LockedElementsExceptionList))
                    {
                        if (typeof(ConfigurationElement).IsAssignableFrom(validProp.Type))
                        {
                            if (sb.Length != 0)
                                sb.Append(", ");
                            sb.Append('\'');
                            sb.Append(validProp.Name);
                            sb.Append('\'');
                        }
                    }
                    else
                    {
                        if (!typeof(ConfigurationElement).IsAssignableFrom(validProp.Type))
                        {
                            if (sb.Length != 0)
                                sb.Append(", ");
                            sb.Append('\'');
                            sb.Append(validProp.Name);
                            sb.Append('\'');
                        }
                    }
                }
            }

            string format;

            if ((lockedType == ConfigurationLockCollectionType.LockedElements) ||
                (lockedType == ConfigurationLockCollectionType.LockedElementsExceptionList))
            {
                format = value != null ? SR.Config_base_invalid_element_to_lock : SR.Config_base_invalid_element_to_lock_by_add;
            }
            else
            {
                format = value != null ? SR.Config_base_invalid_attribute_to_lock : SR.Config_base_invalid_attribute_to_lock_by_add;
            }

            if (value != null)
            {
                throw new ConfigurationErrorsException(
                    SR.Format(format, attribToLockTrim, sb),
                    value.SourceInfo.FileName, value.SourceInfo.LineNumber);
            }

            throw new ConfigurationErrorsException(SR.Format(format,
                attribToLockTrim, sb));
        }

        private ConfigurationLockCollection ParseLockedAttributes(ConfigurationValue value,
            ConfigurationLockCollectionType lockType)
        {
            // check that only actual properties are in the lock attribute
            ConfigurationLockCollection localLockedAttributesList = new ConfigurationLockCollection(this, lockType);
            string attributeList = (string)value.Value;

            if (string.IsNullOrEmpty(attributeList))
            {
                switch (lockType)
                {
                    case ConfigurationLockCollectionType.LockedAttributes:
                        throw new ConfigurationErrorsException(SR.Format(SR.Empty_attribute, LockAttributesKey),
                            value.SourceInfo.FileName, value.SourceInfo.LineNumber);
                    case ConfigurationLockCollectionType.LockedElements:
                        throw new ConfigurationErrorsException(SR.Format(SR.Empty_attribute, LockElementsKey),
                            value.SourceInfo.FileName, value.SourceInfo.LineNumber);
                    case ConfigurationLockCollectionType.LockedExceptionList:
                        throw new ConfigurationErrorsException(
                            SR.Format(SR.Config_empty_lock_attributes_except, LockAllAttributesExceptKey,
                                LockAttributesKey), value.SourceInfo.FileName, value.SourceInfo.LineNumber);
                    case ConfigurationLockCollectionType.LockedElementsExceptionList:
                        throw new ConfigurationErrorsException(
                            SR.Format(SR.Config_empty_lock_element_except, LockAllElementsExceptKey, LockElementsKey),
                            value.SourceInfo.FileName, value.SourceInfo.LineNumber);
                }
            }

            string[] attribsToLock = attributeList.Split(',', ':', ';');
            foreach (string attribToLock in attribsToLock)
            {
                string attribToLockTrim = attribToLock.Trim();
                if (!string.IsNullOrEmpty(attribToLockTrim))
                {
                    // validate that the locks are good
                    if (!(((lockType == ConfigurationLockCollectionType.LockedElements) ||
                        (lockType == ConfigurationLockCollectionType.LockedAttributes)) &&
                        (attribToLockTrim == LockAll)))
                    {
                        ConfigurationProperty propToLock = Properties[attribToLockTrim];

                        if ((propToLock == null) || // if the prop does not exist
                            (attribToLockTrim == LockAttributesKey) || // or it is the lockattributes keyword
                            (attribToLockTrim == LockAllAttributesExceptKey) || // or it is the lockattributes keyword
                            (attribToLockTrim == LockElementsKey) || // or it is the lockelements keyword
                            ((lockType != ConfigurationLockCollectionType.LockedElements) &&
                            (lockType != ConfigurationLockCollectionType.LockedElementsExceptionList) &&
                            typeof(ConfigurationElement).IsAssignableFrom(propToLock.Type)) ||
                            // or if not locking elements but the property is an element
                            (((lockType == ConfigurationLockCollectionType.LockedElements) ||
                            (lockType == ConfigurationLockCollectionType.LockedElementsExceptionList)) &&
                            !typeof(ConfigurationElement).IsAssignableFrom(propToLock.Type))
                            // or if locking elements but the property is not an element
                            )
                        {
                            // check to see if this is a collection and we are locking a collection element

                            ConfigurationElementCollection collection = this as ConfigurationElementCollection;
                            if ((collection == null) && (Properties.DefaultCollectionProperty != null))
                            // this is not a collection but it may contain a default collection
                            {
                                collection =
                                    this[Properties.DefaultCollectionProperty] as ConfigurationElementCollection;
                            }
                            if ((collection == null) ||
                                (lockType == ConfigurationLockCollectionType.LockedAttributes) ||
                                // If the collection type is not element then the lock is bogus
                                (lockType == ConfigurationLockCollectionType.LockedExceptionList))
                                ReportInvalidLock(attribToLockTrim, lockType, value, null);
                            else
                            {
                                if (!collection.IsLockableElement(attribToLockTrim))
                                    ReportInvalidLock(attribToLockTrim, lockType, value, collection.LockableElements);
                            }
                        }

                        if ((propToLock != null) && propToLock.IsRequired)
                        {
                            throw new ConfigurationErrorsException(
                                SR.Format(SR.Config_base_required_attribute_lock_attempt, propToLock.Name));
                        }
                    }


                    // concatenate the new attribute.
                    localLockedAttributesList.Add(attribToLockTrim, ConfigurationValueFlags.Default); // Mark as local
                }
            }
            return localLockedAttributesList;
        }

        private StringCollection IntersectLockCollections(ConfigurationLockCollection collection1,
            ConfigurationLockCollection collection2)
        {
            ConfigurationLockCollection smallCollection = collection1.Count < collection2.Count
                ? collection1
                : collection2;
            ConfigurationLockCollection largeCollection = collection1.Count >= collection2.Count
                ? collection1
                : collection2;
            StringCollection intersectionCollection = new StringCollection();

            foreach (string key in smallCollection)
                if (largeCollection.Contains(key) || (key == ElementTagName))
                    intersectionCollection.Add(key); // add the local copy
            return intersectionCollection;
        }


        protected internal virtual void DeserializeElement(XmlReader reader, bool serializeCollectionKey)
        {
            ConfigurationPropertyCollection props = Properties;
            ConfigurationValue lockedAttributesList = null;
            ConfigurationValue lockedAllExceptList = null;
            ConfigurationValue lockedElementList = null;
            ConfigurationValue lockedAllElementsExceptList = null;
            bool itemLockedLocally = false;

            ElementPresent = true;

            ConfigurationElement defaultCollection = null;
            ConfigurationProperty defaultCollectionProperty = props?.DefaultCollectionProperty;
            if (defaultCollectionProperty != null)
                defaultCollection = (ConfigurationElement)this[defaultCollectionProperty];

            // Process attributes
            ElementTagName = reader.Name;
            PropertySourceInfo rootInfo = new PropertySourceInfo(reader);
            Values.SetValue(reader.Name, null, ConfigurationValueFlags.Modified, rootInfo);
            Values.SetValue(DefaultCollectionPropertyName, defaultCollection, ConfigurationValueFlags.Modified,
                rootInfo);

            if (((_lockedElementsList != null) && (_lockedElementsList.Contains(reader.Name) ||
                (_lockedElementsList.Contains(LockAll) && (reader.Name != ElementTagName)))) ||
                ((_lockedAllExceptElementsList != null) && (_lockedAllExceptElementsList.Count != 0) &&
                !_lockedAllExceptElementsList.Contains(reader.Name)) ||
                (((_itemLockedFlag & ConfigurationValueFlags.Locked) != 0) &&
                ((_itemLockedFlag & ConfigurationValueFlags.Inherited) != 0))
                )
                throw new ConfigurationErrorsException(SR.Format(SR.Config_base_element_locked, reader.Name), reader);


            if (reader.AttributeCount > 0)
            {
                while (reader.MoveToNextAttribute())
                {
                    string propertyName = reader.Name;
                    if (((_lockedAttributesList != null) &&
                        (_lockedAttributesList.Contains(propertyName) || _lockedAttributesList.Contains(LockAll))) ||
                        ((_lockedAllExceptAttributesList != null) &&
                        !_lockedAllExceptAttributesList.Contains(propertyName))
                        )
                    {
                        if ((propertyName != LockAttributesKey) && (propertyName != LockAllAttributesExceptKey))
                        {
                            throw new ConfigurationErrorsException(
                                SR.Format(SR.Config_base_attribute_locked, propertyName), reader);
                        }
                    }

                    ConfigurationProperty prop = props?[propertyName];
                    if (prop != null)
                    {
                        if (serializeCollectionKey && !prop.IsKey)
                        {
                            throw new ConfigurationErrorsException(
                                SR.Format(SR.Config_base_unrecognized_attribute, propertyName), reader);
                        }

                        Values.SetValue(propertyName,
                            DeserializePropertyValue(prop, reader),
                            ConfigurationValueFlags.Modified,
                            new PropertySourceInfo(reader));
                    }
                    else
                    {
                        // if (deserializing a remove OR an add that does not handle optional attributes)
                        switch (propertyName)
                        {
                            case LockItemKey:
                                try
                                {
                                    itemLockedLocally = bool.Parse(reader.Value);
                                }
                                catch
                                {
                                    throw new ConfigurationErrorsException(
                                        SR.Format(SR.Config_invalid_boolean_attribute, propertyName), reader);
                                }
                                break;
                            case LockAttributesKey:
                                lockedAttributesList = new ConfigurationValue(reader.Value,
                                    ConfigurationValueFlags.Default, new PropertySourceInfo(reader));
                                break;
                            case LockAllAttributesExceptKey:
                                lockedAllExceptList = new ConfigurationValue(reader.Value,
                                    ConfigurationValueFlags.Default, new PropertySourceInfo(reader));
                                break;
                            case LockElementsKey:
                                lockedElementList = new ConfigurationValue(reader.Value,
                                    ConfigurationValueFlags.Default, new PropertySourceInfo(reader));
                                break;
                            case LockAllElementsExceptKey:
                                lockedAllElementsExceptList = new ConfigurationValue(reader.Value,
                                    ConfigurationValueFlags.Default, new PropertySourceInfo(reader));
                                break;
                            default:
                                if (serializeCollectionKey ||
                                    !OnDeserializeUnrecognizedAttribute(propertyName, reader.Value))
                                {
                                    throw new ConfigurationErrorsException(
                                        SR.Format(SR.Config_base_unrecognized_attribute, propertyName),
                                        reader);
                                }
                                break;
                        }
                    }
                }
            }

            reader.MoveToElement();

            // Check for nested elements.
            try
            {
                HybridDictionary nodeFound = new HybridDictionary();
                if (!reader.IsEmptyElement)
                {
                    while (reader.Read())
                        if (reader.NodeType == XmlNodeType.Element)
                        {
                            string propertyName = reader.Name;

                            CheckLockedElement(propertyName, null);

                            ConfigurationProperty prop = props?[propertyName];
                            if (prop != null)
                            {
                                if (prop.IsConfigurationElementType)
                                {
                                    // TODO: Check for duplicates.
                                    if (nodeFound.Contains(propertyName))
                                    {
                                        throw new ConfigurationErrorsException(
                                            SR.Format(SR.Config_base_element_cannot_have_multiple_child_elements,
                                                propertyName), reader);
                                    }

                                    nodeFound.Add(propertyName, propertyName);
                                    ConfigurationElement childElement = (ConfigurationElement)this[prop];
                                    childElement.DeserializeElement(reader, serializeCollectionKey);

                                    // Validate the new element with the per-property Validator
                                    // Note that the per-type validator for childElement has been already executed as part of Deserialize
                                    ValidateElement(childElement, prop.Validator, false);
                                }
                                else
                                {
                                    throw new ConfigurationErrorsException(
                                        SR.Format(SR.Config_base_property_is_not_a_configuration_element,
                                            propertyName), reader);
                                }
                            }
                            else
                            {
                                if (!OnDeserializeUnrecognizedElement(propertyName, reader))
                                {
                                    // Let the default collection, if there is one, handle this node.
                                    if ((defaultCollection == null) ||
                                        !defaultCollection.OnDeserializeUnrecognizedElement(propertyName, reader))
                                    {
                                        throw new ConfigurationErrorsException(
                                            SR.Format(SR.Config_base_unrecognized_element_name, propertyName), reader);
                                    }
                                }
                            }
                        }
                        else
                        {
                            if (reader.NodeType == XmlNodeType.EndElement) break;

                            if ((reader.NodeType == XmlNodeType.CDATA) || (reader.NodeType == XmlNodeType.Text))
                            {
                                throw new ConfigurationErrorsException(
                                    SR.Config_base_section_invalid_content, reader);
                            }
                        }
                }

                EnsureRequiredProperties(serializeCollectionKey);

                // Call the per-type validator for this object
                ValidateElement(this, null, false);
            }
            catch (ConfigurationException e)
            {
                // Catch the generic message from deserialization and include line info if necessary
                if ((e.Filename == null) || (e.Filename.Length == 0))
                    throw new ConfigurationErrorsException(e.Message, reader); // give it some info

                throw;
            }

            if (itemLockedLocally)
            {
                SetLocked();
                _itemLockedFlag = ConfigurationValueFlags.Locked;
            }

            if (lockedAttributesList != null)
            {
                _lockedAttributesList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedAttributes);

                foreach (
                    string key in
                    ParseLockedAttributes(lockedAttributesList, ConfigurationLockCollectionType.LockedAttributes))
                    if (!_lockedAttributesList.Contains(key))
                        _lockedAttributesList.Add(key, ConfigurationValueFlags.Default); // add the local copy
                    else
                    {
                        _lockedAttributesList.Add(key,
                            ConfigurationValueFlags.Modified | ConfigurationValueFlags.Inherited); // add the local copy
                    }
            }

            if (lockedAllExceptList != null)
            {
                ConfigurationLockCollection newCollection = ParseLockedAttributes(lockedAllExceptList,
                    ConfigurationLockCollectionType.LockedExceptionList);
                if (_lockedAllExceptAttributesList == null)
                {
                    // Prevent the list from thinking this was set by a parent.
                    _lockedAllExceptAttributesList = new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedExceptionList, string.Empty, newCollection);
                    _lockedAllExceptAttributesList.ClearSeedList();
                }

                StringCollection intersectionCollection = IntersectLockCollections(_lockedAllExceptAttributesList,
                    newCollection);

                _lockedAllExceptAttributesList.ClearInternal(false);
                foreach (string key in intersectionCollection)
                    _lockedAllExceptAttributesList.Add(key, ConfigurationValueFlags.Default);
            }

            if (lockedElementList != null)
            {
                _lockedElementsList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedElements);

                ConfigurationLockCollection localLockedElementList = ParseLockedAttributes(lockedElementList,
                    ConfigurationLockCollectionType.LockedElements);

                if (props.DefaultCollectionProperty != null)
                // this is not a collection but it may contain a default collection
                {
                    ConfigurationElementCollection collection = this[props.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if ((collection != null) && (collection._lockedElementsList == null))
                        collection._lockedElementsList = _lockedElementsList;
                }

                foreach (string key in localLockedElementList)
                    if (!_lockedElementsList.Contains(key))
                    {
                        _lockedElementsList.Add(key, ConfigurationValueFlags.Default); // add the local copy

                        ConfigurationProperty propToLock = Properties[key];
                        if ((propToLock != null) && typeof(ConfigurationElement).IsAssignableFrom(propToLock.Type))
                            ((ConfigurationElement)this[key]).SetLocked();
                        if (key == LockAll)
                        {
                            foreach (ConfigurationProperty prop in Properties)
                                if (!string.IsNullOrEmpty(prop.Name) &&
                                    prop.IsConfigurationElementType)
                                    ((ConfigurationElement)this[prop]).SetLocked();
                        }
                    }
            }

            if (lockedAllElementsExceptList != null)
            {
                ConfigurationLockCollection newCollection = ParseLockedAttributes(lockedAllElementsExceptList,
                    ConfigurationLockCollectionType.LockedElementsExceptionList);
                if (_lockedAllExceptElementsList == null)
                {
                    _lockedAllExceptElementsList = new ConfigurationLockCollection(this,
                        ConfigurationLockCollectionType.LockedElementsExceptionList, ElementTagName, newCollection);
                    _lockedAllExceptElementsList.ClearSeedList();
                }

                StringCollection intersectionCollection = IntersectLockCollections(_lockedAllExceptElementsList,
                    newCollection);

                if (props.DefaultCollectionProperty != null)
                {
                    // this is not a collection but it may contain a default collection
                    ConfigurationElementCollection collection = this[props.DefaultCollectionProperty] as ConfigurationElementCollection;
                    if ((collection != null) && (collection._lockedAllExceptElementsList == null))
                        collection._lockedAllExceptElementsList = _lockedAllExceptElementsList;
                }

                _lockedAllExceptElementsList.ClearInternal(false);
                foreach (string key in intersectionCollection)
                    if (!_lockedAllExceptElementsList.Contains(key) || (key == ElementTagName))
                        _lockedAllExceptElementsList.Add(key, ConfigurationValueFlags.Default); // add the local copy

                foreach (ConfigurationProperty prop in Properties)
                    if (!(string.IsNullOrEmpty(prop.Name) || _lockedAllExceptElementsList.Contains(prop.Name)) &&
                        prop.IsConfigurationElementType)
                        ((ConfigurationElement)this[prop]).SetLocked();
            }

            // Make sure default collections use the same lock element lists
            if (defaultCollectionProperty != null)
            {
                defaultCollection = (ConfigurationElement)this[defaultCollectionProperty];
                _lockedElementsList ??= new ConfigurationLockCollection(this,
                    ConfigurationLockCollectionType.LockedElements);

                defaultCollection._lockedElementsList = _lockedElementsList;
                if (_lockedAllExceptElementsList == null)
                {
                    _lockedAllExceptElementsList = new ConfigurationLockCollection(this,
                        ConfigurationLockCollectionType.LockedElementsExceptionList, reader.Name);
                    _lockedAllExceptElementsList.ClearSeedList();
                }
                defaultCollection._lockedAllExceptElementsList = _lockedAllExceptElementsList;
            }

            // This has to be the last thing to execute
            PostDeserialize();
        }

        private static object DeserializePropertyValue(ConfigurationProperty prop, XmlReader reader)
        {
            Debug.Assert(prop != null, "prop != null");
            Debug.Assert(reader != null, "reader != null");

            // By default we try to load (i.e. parse/validate ) all properties
            // If a property value is invalid ( cannot be parsed or is not valid ) we will keep the value
            // as string ( from the xml ) and will write it out unchanged if needed
            // If the property value is needed by users the actual exception will be thrown

            string xmlValue = reader.Value;
            object propertyValue = null;

            try
            {
                propertyValue = prop.ConvertFromString(xmlValue);

                // Validate the loaded and converted value
                prop.Validate(propertyValue);
            }
            catch (ConfigurationException ce)
            {
                // If the error is incomplete - complete it :)
                if (string.IsNullOrEmpty(ce.Filename)) ce = new ConfigurationErrorsException(ce.Message, reader);

                // Cannot parse/validate the value. Keep it as string
                propertyValue = new InvalidPropValue(xmlValue, ce);
            }
            catch
            {
                // If this is an exception related to the parsing/validating the
                // value ConfigurationErrorsException should be thrown instead.
                // If not - the exception is ok to surface out of here
                Debug.Fail("Unknown exception type thrown");
            }

            return propertyValue;
        }

        internal static void ValidateElement(ConfigurationElement elem, ConfigurationValidatorBase propValidator,
            bool recursive)
        {
            // Validate a config element with the per-type validator when a per-property ( propValidator ) is not supplied
            // or with the per-prop validator when the element ( elem ) is a child property of another configuration element

            ConfigurationValidatorBase validator = propValidator;

            if ((validator == null) && // Not a property - use the per-type validator
                (elem.ElementProperty != null))
            {
                validator = elem.ElementProperty.Validator;

                // Since ElementProperty can be overridden by derived classes we need to make sure that
                // the validator supports the type of elem every time
                if ((validator != null) && !validator.CanValidate(elem.GetType()))
                {
                    throw new ConfigurationErrorsException(SR.Format(SR.Validator_does_not_support_elem_type,
                        elem.GetType().Name));
                }
            }

            try
            {
                validator?.Validate(elem);
            }
            catch (ConfigurationException)
            {
                // ConfigurationElement validators are allowed to throw ConfigurationErrorsException.
                throw;
            }
            catch (Exception ex)
            {
                throw new ConfigurationErrorsException(SR.Format(SR.Validator_element_not_valid, elem.ElementTagName,
                    ex.Message));
            }

            if (recursive)
            {
                // Validate collection items:
                // Note: this is a bit of a hack - we will exploit the fact that this method is called with recursive == true only when serializing the top level section
                // At deserializtion time the per-element validator for collection items will get executed as part of their deserialization logic
                // However we dont perform validation in the serialization logic ( because at that time the object is unmerged and not all data is present )
                // so we have to do that validation here.
                if (elem is ConfigurationElementCollection)
                {
                    IEnumerator it = ((ConfigurationElementCollection)elem).GetElementsEnumerator();
                    while (it.MoveNext()) ValidateElement((ConfigurationElement)it.Current, null, true);
                }

                // Validate all child elements recursively
                for (int index = 0; index < elem.Values.Count; index++)
                {
                    ConfigurationElement value = elem.Values[index] as ConfigurationElement;

                    if (value != null)
                    {
                        // Run the per-type validator on the child element and proceed with validation in subelements
                        // Note we dont run the per-property validator here since we run those when the property value is set
                        ValidateElement(value, null, true); // per-type
                    }
                }
            }
        }

        private void EnsureRequiredProperties(bool ensureKeysOnly)
        {
            ConfigurationPropertyCollection props = Properties;

            // Make sure all required properties are here
            if (props != null)
            {
                foreach (ConfigurationProperty prop in props)
                    if (prop.IsRequired && !Values.Contains(prop.Name))
                    {
                        // Required properties can be ommited when we need only the keys to be there
                        if (!ensureKeysOnly || prop.IsKey) Values[prop.Name] = OnRequiredPropertyNotFound(prop.Name);
                    }
            }
        }

        protected virtual object OnRequiredPropertyNotFound(string name)
        {
            // Derivied classes can override this to return a value for a required property that is missing
            // Here we treat this as an error though

            throw new ConfigurationErrorsException(SR.Format(SR.Config_base_required_attribute_missing, name),
                PropertyFileName(name),
                PropertyLineNumber(name));
        }

        protected virtual void PostDeserialize()
        {
            // Please try to not add code in here
        }

        protected virtual void PreSerialize(XmlWriter writer)
        {
            // Please try to not add code in here
        }

        protected virtual bool OnDeserializeUnrecognizedAttribute(string name, string value)
        {
            return false;
        }

        protected virtual bool OnDeserializeUnrecognizedElement(string elementName, XmlReader reader)
        {
            return false;
        }

        protected virtual string GetTransformedTypeString(string typeName)
        {
            if ((typeName == null) || (_configRecord == null) || !_configRecord.TypeStringTransformerIsSet)
                return typeName;

            return _configRecord.TypeStringTransformer(typeName);
        }

        protected virtual string GetTransformedAssemblyString(string assemblyName)
        {
            if ((assemblyName == null) || (_configRecord == null) || !_configRecord.AssemblyStringTransformerIsSet)
                return assemblyName;

            return _configRecord.AssemblyStringTransformer(assemblyName);
        }

        internal ConfigurationLockCollection UnMergeLockList(
            ConfigurationLockCollection sourceLockList,
            ConfigurationLockCollection parentLockList,
            ConfigurationSaveMode saveMode)
        {
            if (sourceLockList.ExceptionList == false)
            {
                switch (saveMode)
                {
                    case ConfigurationSaveMode.Modified:
                        {
                            ConfigurationLockCollection tempLockList = new ConfigurationLockCollection(this,
                                sourceLockList.LockType);
                            foreach (string lockedAttributeName in sourceLockList)
                                if (!parentLockList.Contains(lockedAttributeName) ||
                                    sourceLockList.IsValueModified(lockedAttributeName))
                                    tempLockList.Add(lockedAttributeName, ConfigurationValueFlags.Default);
                            return tempLockList;
                        }
                    case ConfigurationSaveMode.Minimal:
                        {
                            ConfigurationLockCollection tempLockList = new ConfigurationLockCollection(this,
                                sourceLockList.LockType);
                            foreach (string lockedAttributeName in sourceLockList)
                                if (!parentLockList.Contains(lockedAttributeName))
                                    tempLockList.Add(lockedAttributeName, ConfigurationValueFlags.Default);
                            return tempLockList;
                        }
                }
            }
            else
            {
                // exception list write out the entire collection unless the entire collection
                // came from the parent.
                if ((saveMode == ConfigurationSaveMode.Modified) || (saveMode == ConfigurationSaveMode.Minimal))
                {
                    bool sameAsParent = false;
                    if (sourceLockList.Count == parentLockList.Count)
                    {
                        sameAsParent = true;
                        foreach (string lockedAttributeName in sourceLockList)
                            if (!parentLockList.Contains(lockedAttributeName) ||
                                (sourceLockList.IsValueModified(lockedAttributeName) &&
                                (saveMode == ConfigurationSaveMode.Modified)))
                                sameAsParent = false;
                    }
                    if (sameAsParent) return null;
                }
            }
            return sourceLockList;
        }

        // Return true if an attribute is one of our reserved locking attributes,
        // false otherwise.
        internal static bool IsLockAttributeName(string name)
        {
            // optimize for common case that attribute name does not start with "lock"
            if (!StringUtil.StartsWithOrdinal(name, "lock")) return false;

            foreach (string lockAttributeName in s_lockAttributeNames) if (name == lockAttributeName) return true;

            return false;
        }
    }
}