.NET 9 RC 1 updates

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheEntryExtensions.xml

@@ -35,7 +35,9 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Provides extension methods for <see cref="T:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions" /> operations.</summary>
+    <summary>
+            Extension methods for <see cref="T:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions" /> operations.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -62,7 +64,9 @@
       <Docs>
         <param name="options">The options to be operated on.</param>
         <param name="absolute">The expiration time, in absolute terms.</param>
-        <summary>Sets an absolute expiration date for the cache entry.</summary>
+        <summary>
+            Sets an absolute expiration date for the cache entry.
+            </summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -90,7 +94,9 @@
       <Docs>
         <param name="options">The options to be operated on.</param>
         <param name="relative">The expiration time, relative to now.</param>
-        <summary>Sets an absolute expiration time, relative to now.</summary>
+        <summary>
+            Sets an absolute expiration time, relative to now.
+            </summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -118,8 +124,10 @@
       <Docs>
         <param name="options">The options to be operated on.</param>
         <param name="offset">The sliding expiration time.</param>
-        <summary>Sets how long the cache entry can be inactive (e.g. not accessed) before it will be removed.
-            This will not extend the entry lifetime beyond the absolute expiration (if set).</summary>
+        <summary>
+            Sets how long the cache entry can be inactive (e.g. not accessed) before it will be removed.
+            This will not extend the entry lifetime beyond the absolute expiration (if set).
+            </summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheEntryOptions.xml

@@ -25,7 +25,9 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Provides the cache options for an entry in <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" />.</summary>
+    <summary>
+            Provides the cache options for an entry in <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" />.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -64,7 +66,9 @@
         <ReturnType>System.Nullable&lt;System.DateTimeOffset&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets an absolute expiration date for the cache entry.</summary>
+        <summary>
+            Gets or sets an absolute expiration date for the cache entry.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -86,7 +90,9 @@
         <ReturnType>System.Nullable&lt;System.TimeSpan&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets an absolute expiration time, relative to now.</summary>
+        <summary>
+            Gets or sets an absolute expiration time, relative to now.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -108,8 +114,10 @@
         <ReturnType>System.Nullable&lt;System.TimeSpan&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
-            This will not extend the entry lifetime beyond the absolute expiration (if set).</summary>
+        <summary>
+            Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
+            This will not extend the entry lifetime beyond the absolute expiration (if set).
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml

@@ -35,7 +35,9 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Extension methods for setting data in an <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" />.</summary>
+    <summary>
+            Extension methods for setting data in an <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" />.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -62,7 +64,9 @@
       <Docs>
         <param name="cache">The cache in which to store the data.</param>
         <param name="key">The key to get the stored data for.</param>
-        <summary>Gets a string from the specified cache with the specified key.</summary>
+        <summary>
+            Gets a string from the specified cache with the specified key.
+            </summary>
         <returns>The string value from the stored cache key.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -91,7 +95,9 @@
         <param name="cache">The cache in which to store the data.</param>
         <param name="key">The key to get the stored data for.</param>
         <param name="token">Optional. A <see cref="T:System.Threading.CancellationToken" /> to cancel the operation.</param>
-        <summary>Asynchronously gets a string from the specified cache with the specified key.</summary>
+        <summary>
+            Asynchronously gets a string from the specified cache with the specified key.
+            </summary>
         <returns>A task that gets the string value from the stored cache key.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.GetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String)" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
@@ -122,10 +128,11 @@
         <param name="cache">The cache in which to store the data.</param>
         <param name="key">The key to store the data in.</param>
         <param name="value">The data to store in the cache.</param>
-        <summary>Sets a sequence of bytes in the specified cache with the specified key.</summary>
+        <summary>
+            Sets a sequence of bytes in the specified cache with the specified key.
+            </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetAsync">
@@ -154,12 +161,13 @@
         <param name="key">The key to store the data in.</param>
         <param name="value">The data to store in the cache.</param>
         <param name="token">Optional. A <see cref="T:System.Threading.CancellationToken" /> to cancel the operation.</param>
-        <summary>Asynchronously sets a sequence of bytes in the specified cache with the specified key.</summary>
+        <summary>
+            Asynchronously sets a sequence of bytes in the specified cache with the specified key.
+            </summary>
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.Set(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.Byte[])" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetString">
@@ -187,10 +195,11 @@
         <param name="cache">The cache in which to store the data.</param>
         <param name="key">The key to store the data in.</param>
         <param name="value">The data to store in the cache.</param>
-        <summary>Sets a string in the specified cache with the specified key.</summary>
+        <summary>
+            Sets a string in the specified cache with the specified key.
+            </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetString">
@@ -220,10 +229,11 @@
         <param name="key">The key to store the data in.</param>
         <param name="value">The data to store in the cache.</param>
         <param name="options">The cache options for the entry.</param>
-        <summary>Sets a string in the specified cache with the specified key.</summary>
+        <summary>
+            Sets a string in the specified cache with the specified key.
+            </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetStringAsync">
@@ -252,12 +262,13 @@
         <param name="key">The key to store the data in.</param>
         <param name="value">The data to store in the cache.</param>
         <param name="token">Optional. A <see cref="T:System.Threading.CancellationToken" /> to cancel the operation.</param>
-        <summary>Asynchronously sets a string in the specified cache with the specified key.</summary>
+        <summary>
+            Asynchronously sets a string in the specified cache with the specified key.
+            </summary>
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String)" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetStringAsync">
@@ -288,12 +299,13 @@
         <param name="value">The data to store in the cache.</param>
         <param name="options">The cache options for the entry.</param>
         <param name="token">Optional. A <see cref="T:System.Threading.CancellationToken" /> to cancel the operation.</param>
-        <summary>Asynchronously sets a string in the specified cache with the specified key.</summary>
+        <summary>
+            Asynchronously sets a string in the specified cache with the specified key.
+            </summary>
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String,Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml

@@ -25,7 +25,9 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Represents a distributed cache of serialized values, with support for low allocation data transfer.</summary>
+    <summary>
+            Represents a distributed cache of serialized values, with support for low allocation data transfer.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -64,7 +66,9 @@
         <param name="key">The key of the entry to create.</param>
         <param name="value">The value for this cache entry.</param>
         <param name="options">The cache options for the entry.</param>
-        <summary>Sets or overwrites a cache item.</summary>
+        <summary>
+            Sets or overwrites a cache item.
+            </summary>
         <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Set(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
@@ -104,7 +108,9 @@
         <param name="value">The value for this cache entry.</param>
         <param name="options">The cache options for the value.</param>
         <param name="token">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
-        <summary>Asynchronously sets or overwrites a cache entry.</summary>
+        <summary>
+            Asynchronously sets or overwrites a cache entry.
+            </summary>
         <returns>To be added.</returns>
         <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.SetAsync(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
       </Docs>
@@ -135,9 +141,11 @@
       <Docs>
         <param name="key">The unique key for the cache item.</param>
         <param name="destination">The target to write the cache contents on success.</param>
-        <summary>Attempts to retrieve an existing cache item.</summary>
+        <summary>
+            Attempt to retrieve an existing cache item.
+            </summary>
         <returns>
-          <see langword="true" /> if the cache item is found, <see langword="false" /> otherwise.</returns>
+          <c>true</c> if the cache item is found, <c>false</c> otherwise.</returns>
         <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Get(System.String)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
@@ -174,9 +182,11 @@
         <param name="key">The unique key for the cache entry.</param>
         <param name="destination">The target to write the cache contents on success.</param>
         <param name="token">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
-        <summary>Asynchronously attempts to retrieve an existing cache entry.</summary>
+        <summary>
+            Asynchronously attempt to retrieve an existing cache entry.
+            </summary>
         <returns>
-          <see langword="true" /> if the cache entry is found, <see langword="false" /> otherwise.</returns>
+          <c>true</c> if the cache entry is found, <c>false</c> otherwise.</returns>
         <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.GetAsync(System.String,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>