// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
//
// Description:
//   Manages the ContextStack for a particular run of Serialization.
//
 
using System.ComponentModel;
using System.Xml;
 
namespace System.Windows.Markup
{
    /// <summary>
    ///     The serialization manager offers three services
    ///     1. To store all of the context information 
    ///         for the current run of serialization on a stack. 
    ///     2. To query a given type for its serializer.
    ///     3. To get and set the serialization mode for 
    ///         a given Expression type
    /// </summary>
    /// <remarks>
    ///     As a measure of optimization it also 
    ///     maintains a cache mapping types to 
    ///     serializers, to avoid the overhead of 
    ///     reflecting for the attribute on every 
    ///     query.
    /// 
    ///     
    /// </remarks>
    //This class is derived from ServiceProviders because
    //some codes in PresentationCore need to access method
    //provided in ServiceProviders but XamlDesignerSerializationManager
    //is in PresentationFramework. When XamlDesignerSerializationManager
    //moved into base or core, we should consider move the methods
    //in ServiceProviders into XamlDesignerSerializationManager.
    public class XamlDesignerSerializationManager : ServiceProviders
    {        
        #region Construction
 
        /// <summary>
        ///     Constructor for XamlDesignerSerializationManager
        /// </summary>
        /// <param name="xmlWriter">
        ///     XmlWriter
        /// </param>
        public XamlDesignerSerializationManager(XmlWriter xmlWriter)
        {
            _xamlWriterMode = XamlWriterMode.Value;
            _xmlWriter = xmlWriter;
        }
 
        #endregion Construction
 
        #region Properties
 
        /// <summary>
        ///     The mode of serialization for 
        ///     all Expressions
        /// </summary>
        public XamlWriterMode XamlWriterMode
        {
            get
            {
                return _xamlWriterMode;
            }
 
            set
            {
                // Validate Input Arguments
                if (!IsValidXamlWriterMode(value)) 
                {
                    throw new InvalidEnumArgumentException("value", (int)value, typeof(XamlWriterMode));
                }
 
                _xamlWriterMode = value;
            }
        }
 
        /// <summary>
        ///     XmlWriter
        /// </summary>
        internal XmlWriter XmlWriter
        {
            get { return _xmlWriter; }
        }
 
        #endregion Properties
 
        #region Internal Methods
 
        internal void ClearXmlWriter()
        {
            _xmlWriter = null;
        }
        
        #endregion
 
        #region Private Methods
 
        private static bool IsValidXamlWriterMode(XamlWriterMode value)
        {
            return value == XamlWriterMode.Value 
                || value == XamlWriterMode.Expression;
        }
 
        #endregion
 
 
        #region Data
 
        private XamlWriterMode _xamlWriterMode; // Serialization modes
        private XmlWriter _xmlWriter; //XmlWriter
 
        #endregion Data
    }
}