Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System.IdentityModel/System/IdentityModel/Tokens/Saml2Id.cs

@@ -0,0 +1,98 @@
+//-----------------------------------------------------------------------
+// <copyright file="Saml2Id.cs" company="Microsoft">
+//     Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace System.IdentityModel.Tokens
+{
+    using System;
+    using System.Xml;
+
+    /// <summary>
+    /// Represents the identifier used for SAML assertions.
+    /// </summary>
+    /// <details>
+    /// This identifier should be unique per [Saml2Core, 1.3.4] 
+    /// and must fit the NCName xml schema definition, which is to say that
+    /// it must begin with a letter or underscore. 
+    /// </details>
+    public class Saml2Id
+    {
+        private string value;
+
+        /// <summary>
+        /// Creates a new ID value based on a GUID.
+        /// </summary>
+        public Saml2Id()
+            : this(System.IdentityModel.UniqueId.CreateRandomId())
+        {
+        }
+
+        /// <summary>
+        /// Creates a new ID whose value is the given string.
+        /// </summary>
+        /// <param name="value">The Saml2 Id.</param>
+        /// <exception cref="ArgumentException">If the value is not a valid NCName.</exception>
+        public Saml2Id(string value)
+        {
+            if (string.IsNullOrEmpty(value))
+            {
+                throw DiagnosticUtility.ExceptionUtility.ThrowHelperArgumentNull("value");
+            }
+
+            try
+            {
+                this.value = XmlConvert.VerifyNCName(value);
+            }
+            catch (XmlException e)
+            {
+                throw DiagnosticUtility.ExceptionUtility.ThrowHelperError(
+                    new ArgumentException(SR.GetString(SR.ID4128), "value", e));
+            }
+        }
+
+        /// <summary>
+        /// Gets the identifier string.
+        /// </summary>
+        public string Value
+        {
+            get { return this.value; }
+        }
+
+        /// <summary>
+        /// Compares two <see cref="Saml2Id"/> for equality.
+        /// </summary>
+        /// <param name="obj">Object to campare to.</param>
+        /// <returns>True if this equals object.  False otherwise.</returns>
+        public override bool Equals(object obj)
+        {
+            if (Object.ReferenceEquals(this, obj))
+            {
+                return true;
+            }
+
+            Saml2Id other = obj as Saml2Id;
+#pragma warning suppress 56506 // PreSharp thinks other can be null-dereffed here
+            return (null != other) && StringComparer.Ordinal.Equals(this.value, other.Value);
+        }
+
+        /// <summary>
+        /// Gets the hash code for the <see cref="Saml2Id"/> as an integer. 
+        /// </summary>
+        /// <returns>The hash code for this object.</returns>
+        public override int GetHashCode()
+        {
+            return this.value.GetHashCode();
+        }
+
+        /// <summary>
+        /// Gets the <see cref="Saml2Id"/> in text format.
+        /// </summary>
+        /// <returns>The string representation of this object.</returns>
+        public override string ToString()
+        {
+            return this.value;
+        }
+    }
+}