Skip to content

Commit 18fdac2

Browse files
dotnet-policy-service[bot]dotnet-policy-service[bot]
authored
Merge pull request #10246 from dotnet/main
Merge main into live
2 parents a11f35d + 9ed6ee3 commit 18fdac2

File tree

59 files changed

+1274
-688
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

59 files changed

+1274
-688
lines changed

‎.repoman.yml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
revision: 1
1+
revision: 2
22
schema-version: 1
33
owner-ms-alias: adegeo
44

@@ -12,6 +12,15 @@ config:
1212

1313
issues:
1414

15+
labeled:
16+
17+
# Temporary label to mark issues as updated for Quest. The label is instantly removed
18+
- check:
19+
- type: query
20+
value: "length(Issue.labels[?name == ':world_map: mapQUEST']) != `0`"
21+
pass:
22+
- labels-remove: [":world_map: mapQUEST"]
23+
1524
reopened:
1625

1726
# Remove won't fix label

‎snippets/csharp/System.ComponentModel/Win32Exception/Overview/win32exception.cs‎

Lines changed: 23 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,29 @@
11
using System;
22
using System.ComponentModel;
3-
//using System.Diagnostics;
43

5-
namespace Win32Exception_CS
6-
{
7-
class Class1 {
8-
static void Main(string[] args) {
4+
namespace Win32Exception_CS;
95

10-
//<snippet1>
11-
try {
12-
System.Diagnostics.Process myProc = new System.Diagnostics.Process();
13-
myProc.StartInfo.FileName = "c:\nonexist.exe"; //Attempting to start a non-existing executable
14-
myProc.Start(); //Start the application and assign it to the process component.
15-
}
16-
catch(Win32Exception w) {
17-
Console.WriteLine(w.Message);
18-
Console.WriteLine(w.ErrorCode.ToString());
19-
Console.WriteLine(w.NativeErrorCode.ToString());
20-
Console.WriteLine(w.StackTrace);
21-
Console.WriteLine(w.Source);
22-
Exception e=w.GetBaseException();
23-
Console.WriteLine(e.Message);
24-
}
25-
//</snippet1>
26-
}
6+
class Class1
7+
{
8+
static void Main(string[] args)
9+
{
10+
//<snippet1>
11+
try
12+
{
13+
System.Diagnostics.Process myProc = new();
14+
myProc.StartInfo.FileName = @"c:\nonexist.exe"; // Attempt to start a non-existent executable
15+
myProc.Start();
16+
}
17+
catch (Win32Exception w)
18+
{
19+
Console.WriteLine(w.Message);
20+
Console.WriteLine(w.ErrorCode.ToString());
21+
Console.WriteLine(w.NativeErrorCode.ToString());
22+
Console.WriteLine(w.StackTrace);
23+
Console.WriteLine(w.Source);
24+
Exception e = w.GetBaseException();
25+
Console.WriteLine(e.Message);
26+
}
27+
//</snippet1>
2728
}
2829
}

‎snippets/csharp/System.Reflection.Emit/AssemblyBuilder/Overview/24895.cs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@ public int MyMethod(int multiplier)
210210
// property value.
211211
object? o2 = null;
212212
if (t is not null)
213-
Activator.CreateInstance(t, new object[] { 5280 });
213+
o2 = Activator.CreateInstance(t, new object[] { 5280 });
214214
Console.WriteLine("o2.Number: {0}", pi?.GetValue(o2, null));
215215
}
216216
}

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

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
</Attribute>
2222
</Attributes>
2323
<Docs>
24-
<summary>To be added.</summary>
24+
<summary>Represents a distributed cache of serialized values, with support for low allocation data transfer.</summary>
2525
<remarks>To be added.</remarks>
2626
</Docs>
2727
<Members>
@@ -53,11 +53,11 @@
5353
<Parameter Name="options" Type="Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions" />
5454
</Parameters>
5555
<Docs>
56-
<param name="key">To be added.</param>
57-
<param name="value">To be added.</param>
58-
<param name="options">To be added.</param>
59-
<summary>To be added.</summary>
60-
<remarks>To be added.</remarks>
56+
<param name="key">The key of the entry to create.</param>
57+
<param name="value">The value for this cache entry.</param>
58+
<param name="options">The cache options for the entry.</param>
59+
<summary>Sets or overwrites a cache item.</summary>
60+
<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>
6161
</Docs>
6262
</Member>
6363
<Member MemberName="SetAsync">
@@ -88,13 +88,13 @@
8888
<Parameter Name="token" Type="System.Threading.CancellationToken" />
8989
</Parameters>
9090
<Docs>
91-
<param name="key">To be added.</param>
92-
<param name="value">To be added.</param>
93-
<param name="options">To be added.</param>
94-
<param name="token">To be added.</param>
95-
<summary>To be added.</summary>
91+
<param name="key">The key of the entry to create.</param>
92+
<param name="value">The value for this cache entry.</param>
93+
<param name="options">The cache options for the value.</param>
94+
<param name="token">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
95+
<summary>Asynchronously sets or overwrites a cache entry.</summary>
9696
<returns>To be added.</returns>
97-
<remarks>To be added.</remarks>
97+
<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>
9898
</Docs>
9999
</Member>
100100
<Member MemberName="TryGet">
@@ -117,11 +117,12 @@
117117
<Parameter Name="destination" Type="System.Buffers.IBufferWriter&lt;System.Byte&gt;" />
118118
</Parameters>
119119
<Docs>
120-
<param name="key">To be added.</param>
121-
<param name="destination">To be added.</param>
122-
<summary>To be added.</summary>
123-
<returns>To be added.</returns>
124-
<remarks>To be added.</remarks>
120+
<param name="key">The unique key for the cache item.</param>
121+
<param name="destination">The target to write the cache contents on success.</param>
122+
<summary>Attempts to retrieve an existing cache item.</summary>
123+
<returns>
124+
<see langword="true" /> if the cache item is found, <see langword="false" /> otherwise.</returns>
125+
<remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Get(System.String)" />, but avoids the array allocation.</remarks>
125126
</Docs>
126127
</Member>
127128
<Member MemberName="TryGetAsync">
@@ -150,12 +151,13 @@
150151
<Parameter Name="token" Type="System.Threading.CancellationToken" />
151152
</Parameters>
152153
<Docs>
153-
<param name="key">To be added.</param>
154-
<param name="destination">To be added.</param>
155-
<param name="token">To be added.</param>
156-
<summary>To be added.</summary>
157-
<returns>To be added.</returns>
158-
<remarks>To be added.</remarks>
154+
<param name="key">The unique key for the cache entry.</param>
155+
<param name="destination">The target to write the cache contents on success.</param>
156+
<param name="token">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
157+
<summary>Asynchronously attempts to retrieve an existing cache entry.</summary>
158+
<returns>
159+
<see langword="true" /> if the cache entry is found, <see langword="false" /> otherwise.</returns>
160+
<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>
159161
</Docs>
160162
</Member>
161163
</Members>

‎xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
</Attribute>
2525
</Attributes>
2626
<Docs>
27-
<summary>To be added.</summary>
27+
<summary>Provides multi-tier caching services building on <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" /> backends.</summary>
2828
<remarks>To be added.</remarks>
2929
</Docs>
3030
<Members>
@@ -215,9 +215,9 @@
215215
<Docs>
216216
<param name="keys">To be added.</param>
217217
<param name="token">To be added.</param>
218-
<summary>To be added.</summary>
218+
<summary>Asynchronously removes the value associated with the key if it exists.</summary>
219219
<returns>To be added.</returns>
220-
<remarks>To be added.</remarks>
220+
<remarks>Implementors should treat <see langword="null" /> as empty.</remarks>
221221
</Docs>
222222
</Member>
223223
<Member MemberName="RemoveAsync">
@@ -241,7 +241,7 @@
241241
<Docs>
242242
<param name="key">To be added.</param>
243243
<param name="token">To be added.</param>
244-
<summary>To be added.</summary>
244+
<summary>Asynchronously removes the value associated with the key if it exists.</summary>
245245
<returns>To be added.</returns>
246246
<remarks>To be added.</remarks>
247247
</Docs>
@@ -267,9 +267,9 @@
267267
<Docs>
268268
<param name="tags">To be added.</param>
269269
<param name="token">To be added.</param>
270-
<summary>To be added.</summary>
270+
<summary>Asynchronously removes all values associated with the specified tags.</summary>
271271
<returns>To be added.</returns>
272-
<remarks>To be added.</remarks>
272+
<remarks>Implementors should treat <see langword="null" /> as empty.</remarks>
273273
</Docs>
274274
</Member>
275275
<Member MemberName="RemoveByTagAsync">
@@ -293,7 +293,7 @@
293293
<Docs>
294294
<param name="tag">To be added.</param>
295295
<param name="token">To be added.</param>
296-
<summary>To be added.</summary>
296+
<summary>Asynchronously removes all values associated with the specified tag.</summary>
297297
<returns>To be added.</returns>
298298
<remarks>To be added.</remarks>
299299
</Docs>

‎xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryFlags.xml‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
</Attribute>
2020
</Attributes>
2121
<Docs>
22-
<summary>To be added.</summary>
22+
<summary>Specifies additional flags that apply to a <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> operation.</summary>
2323
<remarks>To be added.</remarks>
2424
</Docs>
2525
<Members>
@@ -40,7 +40,7 @@
4040
</ReturnValue>
4141
<MemberValue>32</MemberValue>
4242
<Docs>
43-
<summary>To be added.</summary>
43+
<summary>Disables compression for this payload.</summary>
4444
</Docs>
4545
</Member>
4646
<Member MemberName="DisableDistributedCache">
@@ -60,7 +60,7 @@
6060
</ReturnValue>
6161
<MemberValue>12</MemberValue>
6262
<Docs>
63-
<summary>To be added.</summary>
63+
<summary>Disables both reading from and writing to the secondary distributed cache.</summary>
6464
</Docs>
6565
</Member>
6666
<Member MemberName="DisableDistributedCacheRead">
@@ -80,7 +80,7 @@
8080
</ReturnValue>
8181
<MemberValue>4</MemberValue>
8282
<Docs>
83-
<summary>To be added.</summary>
83+
<summary>Disables reading from the secondary distributed cache.</summary>
8484
</Docs>
8585
</Member>
8686
<Member MemberName="DisableDistributedCacheWrite">
@@ -100,7 +100,7 @@
100100
</ReturnValue>
101101
<MemberValue>8</MemberValue>
102102
<Docs>
103-
<summary>To be added.</summary>
103+
<summary>Disables writing to the secondary distributed cache.</summary>
104104
</Docs>
105105
</Member>
106106
<Member MemberName="DisableLocalCache">
@@ -120,7 +120,7 @@
120120
</ReturnValue>
121121
<MemberValue>3</MemberValue>
122122
<Docs>
123-
<summary>To be added.</summary>
123+
<summary>Disables both reading from and writing to the local in-process cache.</summary>
124124
</Docs>
125125
</Member>
126126
<Member MemberName="DisableLocalCacheRead">
@@ -140,7 +140,7 @@
140140
</ReturnValue>
141141
<MemberValue>1</MemberValue>
142142
<Docs>
143-
<summary>To be added.</summary>
143+
<summary>Disables reading from the local in-process cache.</summary>
144144
</Docs>
145145
</Member>
146146
<Member MemberName="DisableLocalCacheWrite">
@@ -160,7 +160,7 @@
160160
</ReturnValue>
161161
<MemberValue>2</MemberValue>
162162
<Docs>
163-
<summary>To be added.</summary>
163+
<summary>Disables writing to the local in-process cache.</summary>
164164
</Docs>
165165
</Member>
166166
<Member MemberName="DisableUnderlyingData">
@@ -180,7 +180,7 @@
180180
</ReturnValue>
181181
<MemberValue>16</MemberValue>
182182
<Docs>
183-
<summary>To be added.</summary>
183+
<summary>Only fetches the value from cache; does not attempt to access the underlying data store.</summary>
184184
</Docs>
185185
</Member>
186186
<Member MemberName="None">
@@ -200,7 +200,7 @@
200200
</ReturnValue>
201201
<MemberValue>0</MemberValue>
202202
<Docs>
203-
<summary>To be added.</summary>
203+
<summary>No additional flags.</summary>
204204
</Docs>
205205
</Member>
206206
</Members>

‎xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml‎

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,12 @@
1414
</Base>
1515
<Interfaces />
1616
<Docs>
17-
<summary>To be added.</summary>
17+
<summary>
18+
<para>Specifies dditional options, such as expiration, that apply to a <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> operation. When options</para>
19+
<para>can be specified at multiple levels (for example, globally and per-call), the values are composed; the</para>
20+
<para>most granular non-<see langword="null" /> value is used, with <see langword="null" /> values being inherited. If no value is specified at</para>
21+
<para>any level, the implementation can choose a reasonable default.</para>
22+
</summary>
1823
<remarks>To be added.</remarks>
1924
</Docs>
2025
<Members>
@@ -51,7 +56,7 @@
5156
<ReturnType>System.Nullable&lt;System.TimeSpan&gt;</ReturnType>
5257
</ReturnValue>
5358
<Docs>
54-
<summary>To be added.</summary>
59+
<summary>Gets or sets the overall cache duration of this entry, passed to the backend distributed cache.</summary>
5560
<value>To be added.</value>
5661
<remarks>To be added.</remarks>
5762
</Docs>
@@ -72,7 +77,7 @@
7277
<ReturnType>System.Nullable&lt;Microsoft.Extensions.Caching.Hybrid.HybridCacheEntryFlags&gt;</ReturnType>
7378
</ReturnValue>
7479
<Docs>
75-
<summary>To be added.</summary>
80+
<summary>Gets or sets additional flags that apply to the requested operation.</summary>
7681
<value>To be added.</value>
7782
<remarks>To be added.</remarks>
7883
</Docs>
@@ -95,7 +100,10 @@
95100
<Docs>
96101
<summary>To be added.</summary>
97102
<value>To be added.</value>
98-
<remarks>To be added.</remarks>
103+
<remarks>
104+
<para>When retrieving a cached value from an external cache store, this value will be used to calculate the local</para>
105+
<para>cache expiration, not exceeding the remaining overall cache lifetime.</para>
106+
</remarks>
99107
</Docs>
100108
</Member>
101109
</Members>

‎xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
</Attribute>
1818
</Attributes>
1919
<Docs>
20-
<summary>To be added.</summary>
20+
<summary>Factory provider for per-type <see cref="T:Microsoft.Extensions.Caching.Hybrid.IHybridCacheSerializer`1" /> instances.</summary>
2121
<remarks>To be added.</remarks>
2222
</Docs>
2323
<Members>
@@ -54,10 +54,11 @@
5454
</Parameter>
5555
</Parameters>
5656
<Docs>
57-
<typeparam name="T">To be added.</typeparam>
58-
<param name="serializer">To be added.</param>
59-
<summary>To be added.</summary>
60-
<returns>To be added.</returns>
57+
<typeparam name="T">The type being serialized/deserialized.</typeparam>
58+
<param name="serializer">The serializer.</param>
59+
<summary>Requests a serializer for the provided type, if possible.</summary>
60+
<returns>
61+
<see langword="true" /> if the factory supports this type, <see langword="false" /> otherwise.</returns>
6162
<remarks>To be added.</remarks>
6263
</Docs>
6364
</Member>

0 commit comments

Comments
 (0)