Merge pull request #9199 from dotnet/main

dotnet · Aug 18, 2023 · c670bc4 · c670bc4
2 parents 0f90da7 + 77b61cd
commit c670bc4
Show file tree

Hide file tree

Showing 34 changed files with 32,189 additions and 31,458 deletions.
diff --git a/xml/System.ComponentModel.DataAnnotations/AllowedValuesAttribute.xml b/xml/System.ComponentModel.DataAnnotations/AllowedValuesAttribute.xml
@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies a list of values that should be allowed in a property.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -55,8 +55,8 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="values">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="values">A list of values that the validated value should be equal to.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.DataAnnotations.AllowedValuesAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -85,10 +85,11 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The object to validate.</param>
+        <summary>Determines whether a specified object is valid. (Overrides <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.IsValid(System.Object)" />)</summary>
+        <returns>
+          <see langword="true" /> if any of the <see cref="P:System.ComponentModel.DataAnnotations.AllowedValuesAttribute.Values" /> are equal to <paramref name="value" />, otherwise <see langword="false" /></returns>
+        <remarks>This method can return <see langword="true" /> if the <paramref name="value" /> is <see langword="null" />, provided that <see langword="null" /> is also specified in one of the <see cref="P:System.ComponentModel.DataAnnotations.AllowedValuesAttribute.Values" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Values">
@@ -113,7 +114,7 @@
         <ReturnType>System.Object[]</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the list of values allowed by this attribute.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.ComponentModel.DataAnnotations/Base64StringAttribute.xml b/xml/System.ComponentModel.DataAnnotations/Base64StringAttribute.xml
@@ -20,8 +20,8 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Specifies that a data field value is a well-formed Base64 string.</summary>
+    <remarks>Recognition of valid Base64 is delegated to the <see cref="T:System.Convert" /> class, using the <see cref="M:System.Convert.TryFromBase64String(System.String,System.Span{System.Byte},System.Int32@)" /> method.</remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -37,7 +37,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.DataAnnotations.Base64StringAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -66,9 +66,10 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The object to validate.</param>
+        <summary>Determines whether a specified object is valid. (Overrides <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.IsValid(System.Object)" />)</summary>
+        <returns>
+          <see langword="true" /> if <paramref name="value" /> is <see langword="null" /> or is a valid Base64 string, otherwise <see langword="false" /></returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.ComponentModel.DataAnnotations/DeniedValuesAttribute.xml b/xml/System.ComponentModel.DataAnnotations/DeniedValuesAttribute.xml
@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies a list of values that should not be allowed in a property.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -55,8 +55,8 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="values">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="values">A list of values that the validated value should not be equal to.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.DataAnnotations.DeniedValuesAttribute" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -85,10 +85,11 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The object to validate.</param>
+        <summary>Determines whether a specified object is valid. (Overrides <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.IsValid(System.Object)" />)</summary>
+        <returns>
+          <see langword="true" /> if none of the <see cref="P:System.ComponentModel.DataAnnotations.DeniedValuesAttribute.Values" /> are equal to <paramref name="value" />, otherwise <see langword="false" />.</returns>
+        <remarks>This method can return <see langword="true" /> if the <paramref name="value" /> is <see langword="null" />, provided that <see langword="null" /> is not specified in any of the <see cref="P:System.ComponentModel.DataAnnotations.DeniedValuesAttribute.Values" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Values">
@@ -113,7 +114,7 @@
         <ReturnType>System.Object[]</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the list of values denied by this attribute.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.ComponentModel.DataAnnotations/LengthAttribute.xml b/xml/System.ComponentModel.DataAnnotations/LengthAttribute.xml
@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies the minimum and maximum length of collection/string data allowed in a property.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -78,9 +78,9 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="name">The name to include in the formatted string.</param>
+        <summary>Applies formatting to a specified error message. (Overrides <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.FormatErrorMessage(System.String)" />)</summary>
+        <returns>A localized string to describe the minimum acceptable length.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -109,10 +109,14 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="value">The object to validate.</param>
+        <summary>Determines whether a specified object is valid. (Overrides <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.IsValid(System.Object)" />)</summary>
+        <returns>
+          <see langword="true" /> if the value is <see langword="null" /> or its length is between the specified minimum length and maximum length, otherwise <see langword="false" /></returns>
+        <remarks>This method returns <see langword="true" /> if the <paramref name="value" /> is <see langword="null" />.
+ It is assumed the <see cref="T:System.ComponentModel.DataAnnotations.RequiredAttribute" /> is used if the value may not be <see langword="null" />.</remarks>
+        <exception cref="T:System.InvalidOperationException">
+          <see cref="P:System.ComponentModel.DataAnnotations.LengthAttribute.MinimumLength" /> is less than zero or <see cref="P:System.ComponentModel.DataAnnotations.LengthAttribute.MaximumLength" /> is less than <see cref="P:System.ComponentModel.DataAnnotations.LengthAttribute.MinimumLength" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="MaximumLength">
@@ -131,7 +135,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the maximum allowable length of the collection/string data.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -152,7 +156,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the minimum allowable length of the collection/string data.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.ComponentModel.DataAnnotations/RangeAttribute.xml b/xml/System.ComponentModel.DataAnnotations/RangeAttribute.xml
@@ -438,7 +438,7 @@ This property has no effect on the constructors with <xref:System.Int32> or <xre
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies whether validation should fail for values that are equal to <see cref="P:System.ComponentModel.DataAnnotations.RangeAttribute.Maximum" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -510,7 +510,7 @@ This property has no effect on the constructors with <xref:System.Int32> or <xre
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies whether validation should fail for values that are equal to <see cref="P:System.ComponentModel.DataAnnotations.RangeAttribute.Minimum" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.Linq/Enumerable.xml b/xml/System.Linq/Enumerable.xml
@@ -12994,7 +12994,7 @@ In Visual Basic query expression syntax, an `Aggregate Into Sum()` clause transl
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- 
+
 Items in `source` that are `null` are excluded from the computation of the sum. This method returns zero if `source` contains no elements or all elements are `null`.
 
 In Visual Basic query expression syntax, an `Aggregate Into Sum()` clause translates to an invocation of <xref:System.Linq.Enumerable.Sum%2A>.
@@ -15015,12 +15015,14 @@ If `count` is not a positive number, this method returns an empty enumerable col
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="TKey">To be added.</typeparam>
-        <typeparam name="TValue">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="TKey">The type of the keys from elements of <paramref name="source"/>.</typeparam>
+        <typeparam name="TValue">The type of the values from elements of <paramref name="source"/>.</typeparam>
+        <param name="source">The enumeration to create a dictionary from.</param>
+        <summary>Creates a dictionary from an enumeration according to the default comparer for the key type.</summary>
+        <returns>A dictionary that contains keys and values from <paramref name="source"/> and uses the default comparer for the key type.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="source"/> is a <see langword="null" /> reference.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="source"/> contains one or more duplicate keys.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToDictionary&lt;TKey,TValue&gt;">
@@ -15070,12 +15072,14 @@ If `count` is not a positive number, this method returns an empty enumerable col
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="TKey">To be added.</typeparam>
-        <typeparam name="TValue">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="TKey">The type of the keys from elements of <paramref name="source"/>.</typeparam>
+        <typeparam name="TValue">The type of the values from elements of <paramref name="source"/>.</typeparam>
+        <param name="source">The enumeration to create a dictionary from.</param>
+        <summary>Creates a dictionary from an enumeration according to the default comparer for the key type.</summary>
+        <returns>A dictionary that contains keys and values from <paramref name="source"/> and uses default comparer for the key type.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="source"/> is a <see langword="null" /> reference.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="source"/> contains one or more duplicate keys.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToDictionary&lt;TKey,TValue&gt;">
@@ -15129,13 +15133,15 @@ If `count` is not a positive number, this method returns an empty enumerable col
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="TKey">To be added.</typeparam>
-        <typeparam name="TValue">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <param name="comparer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <typeparam name="TKey">The type of the keys from elements of <paramref name="source"/>.</typeparam>
+        <typeparam name="TValue">The type of the values from elements of <paramref name="source"/>.</typeparam>
+        <param name="source">The enumeration to create a dictionary from.</param>
+        <param name="comparer">An equality comparer to compare keys.</param>
+        <summary>Creates a dictionary from an enumeration according to specified key comparer.</summary>
+        <returns>A dictionary that contains keys and values from <paramref name="source"/>.</returns>
+        <remarks>If <paramref name="comparer"/> is <see langword="null" />, the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default"/> is used to compare keys.</remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="source"/> is a <see langword="null" /> reference.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="source"/> contains one or more duplicate keys.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToDictionary&lt;TKey,TValue&gt;">
@@ -15193,13 +15199,15 @@ If `count` is not a positive number, this method returns an empty enumerable col
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="TKey">To be added.</typeparam>
-        <typeparam name="TValue">To be added.</typeparam>
-        <param name="source">To be added.</param>
-        <param name="comparer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <typeparam name="TKey">The type of the keys from elements of <paramref name="source"/>.</typeparam>
+        <typeparam name="TValue">The type of the values from elements of <paramref name="source"/>.</typeparam>
+        <param name="source">The enumeration to create a dictionary from.</param>
+        <param name="comparer">An equality comparer to compare keys.</param>
+        <summary>Creates a dictionary from an enumeration according to specified key equality comparer.</summary>
+        <returns>A dictionary that contains keys and values from <paramref name="source"/>.</returns>
+        <remarks>If <paramref name="comparer"/> is <see langword="null" />, the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default"/> is used to compare keys.</remarks>
+        <exception cref="T:System.ArgumentNullException"><paramref name="source"/> is a <see langword="null" /> reference.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="source"/> contains one or more duplicate keys.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToDictionary&lt;TSource,TKey&gt;">