Port documentation for .NET 7.0 Preview4 (#8127)

* Microsoft.Extensions.Caching.Memory

* Microsoft.Extensions.Configuration

* Microsoft.Extensions.DependencyInjection

* System.ComponentModel.DataAnnotations

* System.Diagnostics.Activity

* System.Diagnostics

* System.Diagnostics.CodeAnalysis

* System.Formats.Tar

* System.IO.Hashing

* System.Numerics

* System.Runtime.CompilerServices

* System.Runtime.InteropServices

* System.ServiceProcess

* System.Text.Json

* System.Text.RegularExpressions

* System.Threading.Tasks

* System.Timers

* System (Globalization)

* System (Memory)

* System (GC)

* System (Built-in types and everything else)


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

Author: carlossanlop

xml/Microsoft.Extensions.Caching.Memory/IMemoryCache.xml

@@ -79,8 +79,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets a snapshot of the cache statistics if available.</summary>
+        <returns>An instance of <see cref="T:Microsoft.Extensions.Caching.Memory.MemoryCacheStatistics" /> containing a snapshot of the cache statistics.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml

@@ -329,8 +329,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets a snapshot of the current statistics for the memory cache.</summary>
+        <returns>Returns <see langword="null" /> if statistics are not being tracked because <see cref="P:Microsoft.Extensions.Caching.Memory.MemoryCacheOptions.TrackStatistics" /> is <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml

@@ -284,7 +284,7 @@ Prior to .NET 7 this feature was always enabled.
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets whether to track memory cache statistics. Disabled by default.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Caching.Memory/MemoryCacheStatistics.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Holds a snapshot of statistics for a memory cache.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes an instance of the <see cref="T:Microsoft.Extensions.Caching.Memory.MemoryCacheStatistics"/> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -51,7 +51,7 @@
         <ReturnType>System.Int64</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the number of <see cref="T:Microsoft.Extensions.Caching.Memory.ICacheEntry" /> instances currently in the memory cache.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -72,8 +72,8 @@
         <ReturnType>System.Nullable&lt;System.Int64&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets an estimated sum of all the <see cref="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.Size" /> values currently in the memory cache.</summary>
+        <value>Returns <see langword="null" /> if size isn't being tracked. The common MemoryCache implementation tracks size whenever a SizeLimit is set on the cache.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -93,7 +93,7 @@
         <ReturnType>System.Int64</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the total number of cache hits.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -114,7 +114,7 @@
         <ReturnType>System.Int64</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the total number of cache misses.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.xml

@@ -79,7 +79,7 @@
         <ReturnType>Microsoft.Extensions.Configuration.IConfiguration</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the chained configuration.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml

@@ -465,8 +465,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Makes this collection read-only.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+After the collection is marked as read-only, any further attempt to modify it throws an <xref:System.InvalidOperationException>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Remove">

xml/System.ComponentModel.DataAnnotations/RegularExpressionAttribute.xml

@@ -232,7 +232,7 @@ This override performs the specific regular expression matching of `value` field
         <ReturnType>System.TimeSpan</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the timeout to use when matching the regular expression pattern</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics.CodeAnalysis/StringSyntaxAttribute.xml

@@ -112,7 +112,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing composite formats for string formatting.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -132,7 +132,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing date format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -172,7 +172,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing <see cref="T:System.Enum" /> format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -192,7 +192,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing <see cref="T:System.Guid" /> format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -232,7 +232,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing numeric format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -293,7 +293,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing time format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -313,7 +313,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing <see cref="T:System.TimeSpan" /> format specifiers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -333,7 +333,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing URIs.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -353,7 +353,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The syntax identifier for strings containing XML.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/Activity+Enumerator`1.xml

@@ -17,8 +17,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="T">Type being enumerated.</typeparam>
+    <summary>Enumerates the data stored on an <see cref="T:System.Diagnostics.Activity"/> object.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -44,7 +44,7 @@
         <ReturnType>T</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the element at the current position of the enumerator.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -76,8 +76,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an enumerator that iterates through the data stored on an Activity object.</summary>
+        <returns>
+          <see cref="T:System.Diagnostics.Activity.Enumerator`1" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -98,8 +99,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Advances the enumerator to the next element of the data.</summary>
+        <returns>
+          <see langword="true" /> if the enumerator was successfully advanced to the next element; <see langword="false" /> if the enumerator has passed the end of the collection.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/Activity.xml

@@ -381,7 +381,7 @@ This key/value pair is included in the collection returned by the <xref:System.D
         <ReturnType>System.EventHandler&lt;System.Diagnostics.ActivityChangedEventArgs&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Occurs when the <see cref="P:System.Diagnostics.Activity.Current" /> value changes.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -548,8 +548,9 @@ If the `DisplayName` property is not set, it will return the same value as `Oper
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Enumerates the <see cref="T:System.Diagnostics.ActivityEvent" /> objects attached to this Activity object.</summary>
+        <returns>
+          <see cref="T:System.Diagnostics.Activity.Enumerator`1" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -570,8 +571,9 @@ If the `DisplayName` property is not set, it will return the same value as `Oper
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Enumerates the <see cref="T:System.Diagnostics.ActivityLink" /> objects attached to this Activity object.</summary>
+        <returns>
+          <see cref="T:System.Diagnostics.Activity.Enumerator`1" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -592,8 +594,9 @@ If the `DisplayName` property is not set, it will return the same value as `Oper
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Enumerates the tags attached to this Activity object.</summary>
+        <returns>
+          <see cref="T:System.Diagnostics.Activity.Enumerator`1" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Diagnostics/ActivityChangedEventArgs.xml

@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides data for the <see cref="E:System.Diagnostics.Activity.CurrentChanged" /> event.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -40,7 +40,7 @@
         <ReturnType>System.Diagnostics.Activity</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:System.Diagnostics.Activity" /> object after the event.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -61,7 +61,7 @@
         <ReturnType>System.Diagnostics.Activity</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the <see cref="T:System.Diagnostics.Activity" /> object before the event.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>