Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System.Web/UI/PersistChildrenAttribute.cs

@@ -0,0 +1,112 @@
+//------------------------------------------------------------------------------
+// <copyright file="PersistChildrenAttribute.cs" company="Microsoft">
+//     Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>                                                                
+//------------------------------------------------------------------------------
+
+namespace System.Web.UI {
+
+    using System;
+    using System.ComponentModel;
+
+    /// <devdoc>
+    ///    <para> 
+    ///       Indicates whether
+    ///       the contents within a tag representing a custom
+    ///       or Web control should be treated as literal text. Web controls supporting complex properties, like
+    ///       templates, and
+    ///       so on, typically mark themselves as "literals", thereby letting the designer
+    ///       infra-structure deal with the persistence of those attributes.</para>
+    /// </devdoc>
+    [AttributeUsage(AttributeTargets.Class)]
+    public sealed class PersistChildrenAttribute : Attribute {
+
+
+        /// <devdoc>
+        ///    <para>Indicates that the children of a control should be persisted at design-time.
+        ///       </para>
+        /// </devdoc>
+        public static readonly PersistChildrenAttribute Yes = new PersistChildrenAttribute(true);
+
+
+        /// <devdoc>
+        ///    <para>Indicates that the children of a control should not be persisted at design-time.</para>
+        /// </devdoc>
+        public static readonly PersistChildrenAttribute No = new PersistChildrenAttribute(false);
+
+
+        /// <devdoc>
+        ///     This marks the default child persistence behavior for a control at design time. (equal to Yes.)
+        /// </devdoc>
+        public static readonly PersistChildrenAttribute Default = Yes;
+
+        private bool _persist;
+        private bool _usesCustomPersistence;
+
+
+        /// <devdoc>
+        /// </devdoc>
+        public PersistChildrenAttribute(bool persist) {
+            _persist = persist;
+        }
+
+        public PersistChildrenAttribute(bool persist, bool usesCustomPersistence) : this(persist) {
+            _usesCustomPersistence = usesCustomPersistence;
+        }
+
+
+        /// <devdoc>
+        ///    <para>Indicates whether the children of a control should be persisted at design-time.
+        ///       This property is read-only.</para>
+        /// </devdoc>
+        public bool Persist {
+            get {
+                return _persist;
+            }
+        }
+
+
+        /// <devdoc>
+        ///    <para>Indicates whether the control does custom persistence.
+        ///       This property is read-only.</para>
+        /// </devdoc>
+        public bool UsesCustomPersistence {
+            get {
+                // if persist is true, we don't use custom persistence.
+                return !_persist && _usesCustomPersistence;
+            }
+        }
+
+
+        /// <devdoc>
+        /// </devdoc>
+        /// <internalonly/>
+        public override int GetHashCode() {
+            return Persist.GetHashCode();
+        }
+
+
+        /// <devdoc>
+        /// </devdoc>
+        /// <internalonly/>
+        public override bool Equals(object obj) {
+            if (obj == this) {
+                return true;
+            }
+
+            if ((obj != null) && (obj is PersistChildrenAttribute)) {
+                return ((PersistChildrenAttribute)obj).Persist == _persist;
+            }
+
+            return false;
+        }
+
+
+        /// <devdoc>
+        /// </devdoc>
+        /// <internalonly/>
+        public override bool IsDefaultAttribute() {
+            return this.Equals(Default);
+        }
+    }
+}