Skip to content

Commit 0d74517

Browse files
authored
Fix that/which grammar (#11141)
1 parent 640aa62 commit 0d74517

Some content is hidden

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

60 files changed

+1102
-1120
lines changed

xml/System.Collections.Specialized/HybridDictionary.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@
7171
<format type="text/markdown"><![CDATA[
7272
7373
## Remarks
74-
This class is recommended for cases where the number of elements in a dictionary is unknown. It takes advantage of the improved performance of a <xref:System.Collections.Specialized.ListDictionary> with small collections, and offers the flexibility of switching to a <xref:System.Collections.Hashtable> which handles larger collections better than <xref:System.Collections.Specialized.ListDictionary>.
74+
This class is recommended for cases where the number of elements in a dictionary is unknown. It takes advantage of the improved performance of a <xref:System.Collections.Specialized.ListDictionary> with small collections, and offers the flexibility of switching to a <xref:System.Collections.Hashtable>, which handles larger collections better than <xref:System.Collections.Specialized.ListDictionary>.
7575
7676
If the initial size of the collection is greater than the optimal size for a <xref:System.Collections.Specialized.ListDictionary>, the collection is stored in a <xref:System.Collections.Hashtable> to avoid the overhead of copying elements from the <xref:System.Collections.Specialized.ListDictionary> to a <xref:System.Collections.Hashtable>.
7777

xml/System.Collections.Specialized/NameObjectCollectionBase.xml

+1-3
Original file line numberDiff line numberDiff line change
@@ -94,9 +94,7 @@
9494
`null` is allowed as a key or as a value.
9595
9696
> [!CAUTION]
97-
> The <xref:System.Collections.Specialized.NameObjectCollectionBase.BaseGet%2A> method does not distinguish between `null` which is returned because the specified key is not found and `null` which is returned because the value associated with the key is `null`.
98-
99-
97+
> The <xref:System.Collections.Specialized.NameObjectCollectionBase.BaseGet%2A> method does not distinguish between `null` that's returned because the specified key is not found and `null` that's returned because the value associated with the key is `null`.
10098
10199
## Examples
102100
The following code example shows how to implement and use the <xref:System.Collections.Specialized.NameObjectCollectionBase> class.

xml/System.Collections.Specialized/NameValueCollection.xml

+1-3
Original file line numberDiff line numberDiff line change
@@ -76,9 +76,7 @@
7676
`null` is allowed as a key or as a value.
7777
7878
> [!CAUTION]
79-
> The <xref:System.Collections.Specialized.NameValueCollection.Get%2A> method does not distinguish between `null` which is returned because the specified key is not found and `null` which is returned because the value associated with the key is `null`.
80-
81-
79+
> The <xref:System.Collections.Specialized.NameValueCollection.Get%2A> method does not distinguish between `null` that's returned because the specified key is not found and `null` that's returned because the value associated with the key is `null`.
8280
8381
## Examples
8482
:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Collections.Specialized.NameValueCollection2/CPP/nvc.cpp" id="Snippet1":::

xml/System.Collections/ArrayList.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1911,8 +1911,8 @@ This method is an `O(1)` operation.
19111911
<Docs>
19121912
<param name="index">The zero-based <see cref="T:System.Collections.ArrayList" /> index at which the range starts.</param>
19131913
<param name="count">The number of elements in the range.</param>
1914-
<summary>Returns an <see cref="T:System.Collections.ArrayList" /> which represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</summary>
1915-
<returns>An <see cref="T:System.Collections.ArrayList" /> which represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</returns>
1914+
<summary>Returns an <see cref="T:System.Collections.ArrayList" /> that represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</summary>
1915+
<returns>An <see cref="T:System.Collections.ArrayList" /> that represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</returns>
19161916
<remarks>
19171917
<format type="text/markdown"><![CDATA[
19181918

xml/System.Collections/Hashtable.xml

+6-6
Original file line numberDiff line numberDiff line change
@@ -652,7 +652,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
652652
</Parameters>
653653
<Docs>
654654
<param name="d">The <see cref="T:System.Collections.IDictionary" /> object to copy to a new <see cref="T:System.Collections.Hashtable" /> object.</param>
655-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
655+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
656656
<summary>Initializes a new instance of the <see cref="T:System.Collections.Hashtable" /> class by copying the elements from the specified dictionary to the new <see cref="T:System.Collections.Hashtable" /> object. The new <see cref="T:System.Collections.Hashtable" /> object has an initial capacity equal to the number of elements copied, and uses the specified load factor, and the default hash code provider and comparer.</summary>
657657
<remarks>
658658
<format type="text/markdown"><![CDATA[
@@ -934,7 +934,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
934934
</Parameters>
935935
<Docs>
936936
<param name="capacity">The approximate number of elements that the <see cref="T:System.Collections.Hashtable" /> object can initially contain.</param>
937-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
937+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
938938
<summary>Initializes a new, empty instance of the <see cref="T:System.Collections.Hashtable" /> class using the specified initial capacity and load factor, and the default hash code provider and comparer.</summary>
939939
<remarks>
940940
<format type="text/markdown"><![CDATA[
@@ -1233,7 +1233,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
12331233
</Parameters>
12341234
<Docs>
12351235
<param name="d">The <see cref="T:System.Collections.IDictionary" /> object to copy to a new <see cref="T:System.Collections.Hashtable" /> object.</param>
1236-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
1236+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
12371237
<param name="equalityComparer">The <see cref="T:System.Collections.IEqualityComparer" /> object that defines the hash code provider and the comparer to use with the <see cref="T:System.Collections.Hashtable" />.
12381238

12391239
-or-
@@ -1435,7 +1435,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
14351435
</Parameters>
14361436
<Docs>
14371437
<param name="capacity">The approximate number of elements that the <see cref="T:System.Collections.Hashtable" /> object can initially contain.</param>
1438-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
1438+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
14391439
<param name="equalityComparer">The <see cref="T:System.Collections.IEqualityComparer" /> object that defines the hash code provider and the comparer to use with the <see cref="T:System.Collections.Hashtable" />.
14401440

14411441
-or-
@@ -1550,7 +1550,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
15501550
</Parameters>
15511551
<Docs>
15521552
<param name="d">The <see cref="T:System.Collections.IDictionary" /> object to copy to a new <see cref="T:System.Collections.Hashtable" /> object.</param>
1553-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
1553+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
15541554
<param name="hcp">The <see cref="T:System.Collections.IHashCodeProvider" /> object that supplies the hash codes for all keys in the <see cref="T:System.Collections.Hashtable" />.
15551555

15561556
-or-
@@ -1660,7 +1660,7 @@ Each element is a key/value pair stored in a <xref:System.Collections.Dictionary
16601660
</Parameters>
16611661
<Docs>
16621662
<param name="capacity">The approximate number of elements that the <see cref="T:System.Collections.Hashtable" /> object can initially contain.</param>
1663-
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value which provides the best performance. The result is the maximum ratio of elements to buckets.</param>
1663+
<param name="loadFactor">A number in the range from 0.1 through 1.0 that is multiplied by the default value that provides the best performance. The result is the maximum ratio of elements to buckets.</param>
16641664
<param name="hcp">The <see cref="T:System.Collections.IHashCodeProvider" /> object that supplies the hash codes for all keys in the <see cref="T:System.Collections.Hashtable" />.
16651665

16661666
-or-

xml/System.Diagnostics.Metrics/MeterListener.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -274,8 +274,8 @@
274274
</Parameters>
275275
<Docs>
276276
<typeparam name="T">The type of the numeric measurement.</typeparam>
277-
<param name="measurementCallback">The callback which can be used to get measurement recording of numeric type T.</param>
278-
<summary>Sets a callback for a specific numeric type to get the measurement recording notification from all instruments which enabled listening and was created with the same specified numeric type.
277+
<param name="measurementCallback">The callback that can be used to get measurement recording of numeric type T.</param>
278+
<summary>Sets a callback for a specific numeric type to get the measurement recording notification from all instruments that enabled listening and were created with the same specified numeric type.
279279
If a measurement of type T is recorded and a callback of type T is registered, that callback will be used.</summary>
280280
<remarks>To be added.</remarks>
281281
</Docs>

xml/System.Diagnostics/ActivityCreationOptions`1.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ The possible generic type parameters are <see cref="T:System.Diagnostics.Activit
6767
<ReturnType>System.Diagnostics.ActivityKind</ReturnType>
6868
</ReturnValue>
6969
<Docs>
70-
<summary>Gets the activity kind which the activity will be created with.</summary>
70+
<summary>Gets the activity kind that the activity will be created with.</summary>
7171
<value>One of the enumeration values that represent an activity kind.</value>
7272
<remarks>To be added.</remarks>
7373
</Docs>

xml/System.Diagnostics/DiagnosticSource.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -144,8 +144,8 @@ If there is expensive setup for the notification, you can call IsEnabled before
144144
</Parameters>
145145
<Docs>
146146
<param name="name">The name of the event being written.</param>
147-
<param name="arg1">An object that represents the additional context for IsEnabled. Consumers should expect to receive <see langword="null" /> which may indicate that producer called pure IsEnabled(string) to check if consumer wants to get notifications for such events at all. Based on that, producer may call IsEnabled(string, object, object) again with non-<see langword="null" /> context.</param>
148-
<param name="arg2">Optional. An object that represents the additional context for IsEnabled. <see langword="null" /> by default. Consumers should expect to receive <see langword="null" /> which may indicate that producer called pure IsEnabled(string) or producer passed all necessary context in <paramref name="arg1" />.</param>
147+
<param name="arg1">An object that represents the additional context for IsEnabled. Consumers should expect to receive <see langword="null" />, which might indicate that producer called pure IsEnabled(string) to check if consumer wants to get notifications for such events at all. Based on that, producer may call IsEnabled(string, object, object) again with non-<see langword="null" /> context.</param>
148+
<param name="arg2">Optional. An object that represents the additional context for IsEnabled. <see langword="null" /> by default. Consumers should expect to receive <see langword="null" />, which might indicate that producer called pure IsEnabled(string) or producer passed all necessary context in <paramref name="arg1" />.</param>
149149
<summary>Verifies it the notification event is enabled.</summary>
150150
<returns>
151151
<see langword="true" /> if the notification event is enabled, <see langword="false" /> otherwise.</returns>
@@ -546,7 +546,7 @@ Consumers can access <xref:System.Diagnostics.Activity.Current?displayProperty=n
546546
</Parameters>
547547
<Docs>
548548
<param name="name">The name of the event being written.</param>
549-
<param name="value">An object that represents the value being passed as a payload for the event. This is often an anonymous type which contains several sub-values.</param>
549+
<param name="value">An object that represents the value being passed as a payload for the event. This is often an anonymous type that contains several subvalues.</param>
550550
<summary>Provides a generic way of logging complex payloads.
551551
</summary>
552552
<remarks>

0 commit comments

Comments
 (0)