Port System.Security.Claims source comments to Docs (#2307)

* Ported System.Security.Claims source code triple slash comments to dotnet-api-docs

* Apply suggestions from code review

Suggestions from rpetrusha

Co-Authored-By: carlossanlop <[email protected]>

Author: carlossanlop

xml/System.Security.Claims/Claim.xml

@@ -165,6 +165,7 @@ if (null != principal)
         <param name="other">The security claim.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Claims.Claim" /> class.</summary>
         <remarks></remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="other" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -201,6 +202,7 @@ if (null != principal)
         <param name="subject">The subject that this claim describes.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Claims.Claim" /> class with the specified reader and subject.</summary>
         <remarks></remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="reader" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -237,6 +239,7 @@ if (null != principal)
         <param name="subject">The subject that this claim describes.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Security.Claims.Claim" /> class with the specified security claim and subject.</summary>
         <remarks></remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="other" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1044,7 +1047,8 @@ if (null != principal)
         <param name="userData">The user data to claim.</param>
         <summary>Writes this <see cref="T:System.Security.Claims.Claim" /> to the writer.</summary>
         <remarks></remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="writer" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Security.Claims/ClaimsIdentity.xml

@@ -258,6 +258,7 @@
         <summary>Initializes a new instance of the <see cref="T:System.Security.Claims.ClaimsIdentity" /> class from a serialized stream created by using <see cref="T:System.Runtime.Serialization.ISerializable" />.</summary>
         <remarks></remarks>
         <permission cref="T:System.Security.SecurityCriticalAttribute">requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.</permission>
+        <exception cref="T:System.ArgumentNullException"><paramref name="info" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -747,6 +748,7 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException"><paramref name="identity" /> is a <see cref="T:System.Security.Claims.ClaimsIdentity" /> and <see cref="P:System.Security.Claims.ClaimsIdentity.Actor" /> results in a circular reference back to <see langword="this" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Actor">
@@ -1994,4 +1996,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Security.Claims/ClaimsPrincipal.xml

@@ -627,6 +627,7 @@ if (null != principal)
         <summary>Creates a new claims identity.</summary>
         <returns>The created claims identity.</returns>
         <remarks></remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="reader" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="Current">
@@ -1320,4 +1321,4 @@ if (null != principal)
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>