Automatic port of System.Collections exceptions (#4689)

* Automatic port of System.Collections exceptions

* Apply suggestions from code review

Co-authored-by: carlossanlop <[email protected]>

Author: carlossanlop

xml/System.Collections.Concurrent/ConcurrentDictionary`2.xml

@@ -1208,6 +1208,9 @@
         <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/">Thread-Safe Collections</related>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/how-to-add-and-remove-items">How to: Add and Remove Items from a ConcurrentDictionary</related>
+        <exception cref="T:System.ArgumentNullException">The <see cref="P:System.Collections.Generic.KeyValuePair`2.Key" /> of <paramref name="keyValuePair" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.OverflowException">The <see cref="T:System.Collections.Generic.Dictionary`2" /> contains too many elements.</exception>
+        <exception cref="T:System.ArgumentException">An element with the same key already exists in the <see cref="T:System.Collections.Generic.Dictionary`2" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;.Contains">
@@ -1298,6 +1301,16 @@
         <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/">Thread-Safe Collections</related>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/how-to-add-and-remove-items">How to: Add and Remove Items from a ConcurrentDictionary</related>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="array" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="index" /> is less than 0.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="index" /> is equal to or greater than the length of the <paramref name="array" />.
+
+-or-
+
+The number of elements in the source <see cref="T:System.Collections.ICollection" /> is greater than the available space from <paramref name="index" /> to the end of the destination <paramref name="array" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;.IsReadOnly">
@@ -1384,6 +1397,7 @@
         <remarks>To be added.</remarks>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/">Thread-Safe Collections</related>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/how-to-add-and-remove-items">How to: Add and Remove Items from a ConcurrentDictionary</related>
+        <exception cref="T:System.ArgumentNullException">The <see cref="P:System.Collections.Generic.KeyValuePair`2.Key" /> property of <paramref name="keyValuePair" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;.Add">
@@ -2388,6 +2402,7 @@ Both the specifed key and value must match the entry in the dictionary for it to
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentNullException">The <see cref="P:System.Collections.Generic.KeyValuePair`2.Key" /> property of <paramref name="item" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryRemove">

xml/System.Collections.Generic/IReadOnlySet`1.xml

@@ -24,7 +24,7 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
+    <typeparam name="T">The type of elements in the set.</typeparam>
     <summary>Provides a readonly abstraction of a set.</summary>
     <remarks>To be added.</remarks>
   </Docs>

xml/System.Collections.Immutable/ImmutableArray`1.xml

@@ -2318,6 +2318,7 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException">The <see cref="P:System.Collections.Immutable.ImmutableArray`1.IsDefault" /> property returns <see langword="true" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IList&lt;T&gt;.Insert">

xml/System.Collections.Immutable/ImmutableDictionary`2.xml

@@ -863,6 +863,10 @@
         <param name="value">The object to use as the value of the element to add.</param>
         <summary>Adds an element with the provided key and value to the immutable dictionary.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">An element with the same key already exists in the <see cref="T:System.Collections.Generic.IDictionary`2" />.</exception>
+        <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IDictionary`2" /> is read-only.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;.Item">
@@ -965,6 +969,9 @@
         <returns>
           <see langword="true" /> if the element is successfully removed; otherwise, <see langword="false" />.  This method also returns <see langword="false" /> if <paramref name="key" /> was not found in the original generic dictionary.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IDictionary`2" /> is read-only.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;.Values">

xml/System.Collections.Immutable/ImmutableList`1.xml

@@ -1882,7 +1882,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.NotImplementedException" />
+        <exception cref="T:System.NotSupportedException">Always thrown.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;T&gt;.Clear">
@@ -1997,6 +1997,7 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.NotSupportedException">Always thrown.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IEnumerable&lt;T&gt;.GetEnumerator">

xml/System.Collections.Immutable/ImmutableQueue`1.xml

@@ -488,6 +488,7 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException">Thrown when the queue is empty.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Immutable.IImmutableQueue&lt;T&gt;.Enqueue">

xml/System.Collections.Immutable/ImmutableSortedDictionary`2.xml

@@ -843,6 +843,10 @@
         <param name="value">The object to use as the value of the element to add.</param>
         <summary>Adds an element with the provided key and value to the generic dictionary.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">An element with the same key already exists in the <see cref="T:System.Collections.Generic.IDictionary`2" />.</exception>
+        <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IDictionary`2" /> is read-only.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;.Item">
@@ -945,6 +949,9 @@
         <returns>
           <see langword="true" /> if the element is successfully removed; otherwise, <see langword="false" />.  This method also returns <see langword="false" /> if <paramref name="key" /> was not found in the original generic dictionary.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IDictionary`2" /> is read-only.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;.Values">

xml/System.Collections.Immutable/ImmutableStack`1.xml

@@ -485,6 +485,7 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.InvalidOperationException">The stack is empty.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Immutable.IImmutableStack&lt;T&gt;.Push">