Automatically port System.Data triple slash comments (#2674)

* Automatically port System.Data triple slash comments

* suggestions by mairaw

Co-Authored-By: Maira Wenzel <[email protected]>

* Suggestions by mairaw.

* suggestions by divega and mairaw

* suggestion by divega

* remove 2nd sentence in CreateChildView exceptions

* Update DataRowView.xml

Author: carlossanlop

xml/System.Data/ConstraintCollection.xml

@@ -955,8 +955,8 @@
         <ReturnType>System.Collections.ArrayList</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the items of the collection as a list.</summary>
+        <value>The items of the collection as a list.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -985,8 +985,8 @@
         <Parameter Name="ccevent" Type="System.ComponentModel.CollectionChangeEventArgs" Index="0" FrameworkAlternate="netframework-1.1" />
       </Parameters>
       <Docs>
-        <param name="ccevent">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="ccevent">The event data.</param>
+        <summary>Raises the <see cref="E:System.Data.ConstraintCollection.CollectionChanged" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1174,4 +1174,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Data/DataColumnCollection.xml

@@ -950,8 +950,8 @@ Another column's expression depends on this column. </exception>
         <ReturnType>System.Collections.ArrayList</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the items of the collection as a list.</summary>
+        <value>The items of the collection as a list.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -980,8 +980,8 @@ Another column's expression depends on this column. </exception>
         <Parameter Name="ccevent" Type="System.ComponentModel.CollectionChangeEventArgs" Index="0" FrameworkAlternate="netframework-1.1" />
       </Parameters>
       <Docs>
-        <param name="ccevent">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="ccevent">The event data.</param>
+        <summary>Raises the <see cref="M:System.Data.DataColumnCollection.OnCollectionChanged(System.ComponentModel.CollectionChangeEventArgs)" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1200,4 +1200,4 @@ Another column's expression depends on this column. </exception>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Data/DataRowView.xml

@@ -308,6 +308,7 @@
         <summary>Returns a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" /> with the specified <see cref="T:System.Data.DataRelation" /> and parent.</summary>
         <returns>A <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException"><paramref name="relation" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="CreateChildView">
@@ -342,10 +343,11 @@
       </Parameters>
       <Docs>
         <param name="relationName">A string containing the <see cref="T:System.Data.DataRelation" /> name.</param>
-        <param name="followParent">The parent</param>
+        <param name="followParent"><see langword="true" /> to keep the created child view in sync with the parent; otherwise, <see langword="false" />.</param>
         <summary>Returns a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" /> with the specified <see cref="T:System.Data.DataRelation" /> name and parent.</summary>
         <returns>a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException"><paramref name="relation" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="DataView">
@@ -692,7 +694,7 @@
         <Parameter Name="ndx" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="ndx">The specified column.</param>
+        <param name="ndx">The column index.</param>
         <summary>Gets or sets a value in a specified column.</summary>
         <value>The value of the column.</value>
         <remarks>
@@ -706,6 +708,8 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.Data.DataException">The <see cref="P:System.Data.DataRowView.DataView" /> doesn't allow edits and <see cref="T:System.Data.DataRowView" /> is not new.</exception>
+        <exception cref="T:System.IndexOutOfRangeException">No column corresponds to that index value.</exception>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -754,6 +758,11 @@
   
  ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentException">A column with the specified name or relation was not found.
+        
+-or-
+
+The <see cref="P:System.Data.DataRowView.DataView" /> doesn't allow edits and <see cref="T:System.Data.DataRowView" /> is not new.</exception>
       </Docs>
     </Member>
     <Member MemberName="PropertyChanged">
@@ -1564,4 +1573,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Data/DataTableCollection.xml

@@ -1128,8 +1128,8 @@
         <ReturnType>System.Collections.ArrayList</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the items of the collection as a list.</summary>
+        <value>The items of the collection as a list.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1158,8 +1158,8 @@
         <Parameter Name="ccevent" Type="System.ComponentModel.CollectionChangeEventArgs" Index="0" FrameworkAlternate="netframework-1.1" />
       </Parameters>
       <Docs>
-        <param name="ccevent">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="ccevent">The event data.</param>
+        <summary>Raises the <see cref="M:System.Data.DataTableCollection.OnCollectionChanged(System.ComponentModel.CollectionChangeEventArgs)" /> event.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1436,4 +1436,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>