Skip to content

Commit 7d03c24

Browse files
BillWagnerBillWagner
authored
Merge pull request #3679 from dotnet/master
Update live with current master
2 parents 8ae9a18 + 1d7f7b3 commit 7d03c24

File tree

8 files changed

+161
-86
lines changed

8 files changed

+161
-86
lines changed

‎xml/System.Configuration.Internal/DelegatingConfigHost.xml

Lines changed: 26 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -197,9 +197,9 @@
197197
</Parameters>
198198
<Docs>
199199
<param name="encryptedXml">An encrypted section of a configuration file.</param>
200-
<param name="protectionProvider">A <see cref="T:System.Configuration.ProtectedConfigurationProvider" /> object.</param>
201-
<param name="protectedConfigSection">A <see cref="T:System.Configuration.ProtectedConfigurationSection" /> object.</param>
202-
<param name="protectedSection">To be added.</param>
200+
<param name="protectionProvider">An object containing the providers that encrypt and decrypt protected configuration data.</param>
201+
<param name="protectedConfigSection">An object that provides programatic access to the <c>configProtectedData</c> configuration section.</param>
202+
<param name="protectedSection">An object that provides programatic access to the <c>configProtectedData</c> configuration section.</param>
203203
<summary>Decrypts an encrypted configuration section.</summary>
204204
<returns>A string representing a decrypted configuration section.</returns>
205205
<remarks>To be added.</remarks>
@@ -282,10 +282,10 @@
282282
</Parameters>
283283
<Docs>
284284
<param name="clearTextXml">A section of the configuration that is not encrypted.</param>
285-
<param name="encryptedXml">To be added.</param>
286-
<param name="protectionProvider">A <see cref="T:System.Configuration.ProtectedConfigurationProvider" /> object.</param>
287-
<param name="protectedConfigSection">A <see cref="T:System.Configuration.ProtectedConfigurationSection" /> object.</param>
288-
<param name="protectedSection">To be added.</param>
285+
<param name="encryptedXml">A section of the configuration that is not encrypted.</param>
286+
<param name="protectionProvider">An object containing the providers that encrypt and decrypt protected configuration data</param>
287+
<param name="protectedConfigSection">An object that provides programatic access to the <c>configProtectedData</c> configuration section.</param>
288+
<param name="protectedSection">An object that provides programatic access to the <c>configProtectedData</c> configuration section.</param>
289289
<summary>Encrypts a section of a configuration object.</summary>
290290
<returns>A string representing an encrypted section of the configuration object.</returns>
291291
<remarks>To be added.</remarks>
@@ -331,7 +331,7 @@
331331
<Docs>
332332
<param name="configPath">A string representing the path to a configuration file.</param>
333333
<param name="locationSubPath">A string representing a location subpath.</param>
334-
<param name="locatinSubPath">To be added.</param>
334+
<param name="locatinSubPath">A string representing a location subpath.</param>
335335
<summary>Returns a configuration path based on a location subpath.</summary>
336336
<returns>A string representing a configuration path.</returns>
337337
<remarks>To be added.</remarks>
@@ -589,9 +589,11 @@
589589
<ReturnType>System.Boolean</ReturnType>
590590
</ReturnValue>
591591
<Docs>
592-
<summary>To be added.</summary>
593-
<value>To be added.</value>
594-
<remarks>To be added.</remarks>
592+
<summary>Determines if the delegated host has a local configuration.</summary>
593+
<value>
594+
<see langword="true" /> if the current instance has a local configuration; otherwise, <see langword="false" />.</value>
595+
<remarks>To be added.</remarks>
596+
<forInternalUseOnly />
595597
</Docs>
596598
</Member>
597599
<Member MemberName="HasRoamingConfig">
@@ -615,9 +617,11 @@
615617
<ReturnType>System.Boolean</ReturnType>
616618
</ReturnValue>
617619
<Docs>
618-
<summary>To be added.</summary>
619-
<value>To be added.</value>
620-
<remarks>To be added.</remarks>
620+
<summary>Determines if the delegated host has a roaming configuration.</summary>
621+
<value>
622+
<see langword="true" /> if the current instance has a roaming configuration; otherwise, <see langword="false" />.</value>
623+
<remarks>To be added.</remarks>
624+
<forInternalUseOnly />
621625
</Docs>
622626
</Member>
623627
<Member MemberName="Host">
@@ -851,9 +855,11 @@
851855
<ReturnType>System.Boolean</ReturnType>
852856
</ReturnValue>
853857
<Docs>
854-
<summary>To be added.</summary>
855-
<value>To be added.</value>
856-
<remarks>To be added.</remarks>
858+
<summary>Determines if the application configuration file comes from a non-local URI (that is, <c>http://</c>) or is a local file.</summary>
859+
<value>
860+
<see langword="true" /> if the delegated host's sections belong to <c>System.Net</c> and the configuration file for the application is downloaded via HTTP using <see cref="T:System.Net.WebClient" />; otherwise, <see langword="false" />.</value>
861+
<remarks>To be added.</remarks>
862+
<forInternalUseOnly />
857863
</Docs>
858864
</Member>
859865
<Member MemberName="IsConfigRecordRequired">
@@ -1548,8 +1554,9 @@
15481554
</ReturnValue>
15491555
<Parameters />
15501556
<Docs>
1551-
<summary>To be added.</summary>
1552-
<remarks>To be added.</remarks>
1557+
<summary>Invokes the delegated host's method that refreshes configuration paths.</summary>
1558+
<remarks>To be added.</remarks>
1559+
<forInternalUseOnly />
15531560
</Docs>
15541561
</Member>
15551562
<Member MemberName="RequireCompleteInit">

‎xml/System.Configuration/ProtectedConfigurationProvider.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
</Base>
2323
<Interfaces />
2424
<Docs>
25-
<summary>Is the base class to create providers for encrypting and decrypting protected-configuration data.</summary>
25+
<summary>The base class to create providers for encrypting and decrypting protected configuration data.</summary>
2626
<remarks>
2727
<format type="text/markdown"><![CDATA[
2828

‎xml/System.Linq/Enumerable.xml

Lines changed: 32 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9567,12 +9567,22 @@ Only unique elements are returned.
95679567
<Parameter Name="count" Type="System.Int32" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
95689568
</Parameters>
95699569
<Docs>
9570-
<typeparam name="TSource">To be added.</typeparam>
9571-
<param name="source">To be added.</param>
9572-
<param name="count">To be added.</param>
9573-
<summary>To be added.</summary>
9574-
<returns>To be added.</returns>
9575-
<remarks>To be added.</remarks>
9570+
<typeparam name="TSource">The type of the elements in the enumerable collection.</typeparam>
9571+
<param name="source">An enumerable collection instance.</param>
9572+
<param name="count">The number of elements to omit from the end of the collection.</param>
9573+
<summary>Returns a new enumerable collection that contains the elements from <paramref name="source" /> with the last <paramref name="count" /> elements of the source collection omitted.</summary>
9574+
<returns>A new enumerable collection that contains the elements from <paramref name="source" /> minus <paramref name="count" /> elements from the end of the collection.</returns>
9575+
<remarks>
9576+
<format type="text/markdown"><![CDATA[
9577+
9578+
## Remarks
9579+
9580+
If `count` is not a positive number, this method returns an identical copy of the `source` enumerable collection.
9581+
9582+
]]></format>
9583+
</remarks>
9584+
<exception cref="T:System.ArgumentNullException">
9585+
<paramref name="source" /> is <see langword="null" />.</exception>
95769586
</Docs>
95779587
</Member>
95789588
<MemberGroup MemberName="SkipWhile&lt;TSource&gt;">
@@ -11193,12 +11203,22 @@ Only unique elements are returned.
1119311203
<Parameter Name="count" Type="System.Int32" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
1119411204
</Parameters>
1119511205
<Docs>
11196-
<typeparam name="TSource">To be added.</typeparam>
11197-
<param name="source">To be added.</param>
11198-
<param name="count">To be added.</param>
11199-
<summary>To be added.</summary>
11200-
<returns>To be added.</returns>
11201-
<remarks>To be added.</remarks>
11206+
<typeparam name="TSource">The type of the elements in the enumerable collection.</typeparam>
11207+
<param name="source">An enumerable collection instance.</param>
11208+
<param name="count">The number of elements to take from the end of the collection.</param>
11209+
<summary>Returns a new enumerable collection that contains the last <paramref name="count" /> elements from <paramref name="source" />.</summary>
11210+
<returns>A new enumerable collection that contains the last <paramref name="count" /> elements from <paramref name="source" />.</returns>
11211+
<remarks>
11212+
<format type="text/markdown"><![CDATA[
11213+
11214+
## Remarks
11215+
11216+
If `count` is not a positive number, this method returns an empty enumerable collection.
11217+
11218+
]]></format>
11219+
</remarks>
11220+
<exception cref="T:System.ArgumentNullException">
11221+
<paramref name="source" /> is <see langword="null" />.</exception>
1120211222
</Docs>
1120311223
</Member>
1120411224
<MemberGroup MemberName="TakeWhile&lt;TSource&gt;">

‎xml/System.Linq/Queryable.xml

Lines changed: 46 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -508,12 +508,14 @@
508508
<Parameter Name="element" Type="TSource" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
509509
</Parameters>
510510
<Docs>
511-
<typeparam name="TSource">To be added.</typeparam>
512-
<param name="source">To be added.</param>
513-
<param name="element">To be added.</param>
514-
<summary>To be added.</summary>
515-
<returns>To be added.</returns>
511+
<typeparam name="TSource">The type of the elements in the queryable sequence.</typeparam>
512+
<param name="source">A queryable sequence.</param>
513+
<param name="element">An element of type <typeparamref name="TSource" /> to append to <paramref name="source" />.</param>
514+
<summary>Returns a new queryable sequence that contains the elements from <paramref name="source" /> plus the specified <paramref name="element" /> appended at the end.</summary>
515+
<returns>A new queryable sequence that contains the elements from <paramref name="source" /> plus the specified <paramref name="element" /> appended at the end.</returns>
516516
<remarks>To be added.</remarks>
517+
<exception cref="T:System.ArgumentNullException">
518+
<paramref name="source" /> is <see langword="null" />.</exception>
517519
</Docs>
518520
</Member>
519521
<Member MemberName="AsQueryable">
@@ -5160,12 +5162,14 @@
51605162
<Parameter Name="element" Type="TSource" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
51615163
</Parameters>
51625164
<Docs>
5163-
<typeparam name="TSource">To be added.</typeparam>
5164-
<param name="source">To be added.</param>
5165-
<param name="element">To be added.</param>
5166-
<summary>To be added.</summary>
5167-
<returns>To be added.</returns>
5165+
<typeparam name="TSource">The type of the elements in the queryable sequence.</typeparam>
5166+
<param name="source">A queryable sequence.</param>
5167+
<param name="element">An element of type <typeparamref name="TSource" /> to prepend to <paramref name="source" />.</param>
5168+
<summary>Returns a new queryable sequence that contains the elements from <paramref name="source" /> plus the specified <paramref name="element" /> prepended at the beginning.</summary>
5169+
<returns>A new queryable sequence that contains the elements from <paramref name="source" /> plus the specified <paramref name="element" /> prepended at the beginning.</returns>
51685170
<remarks>To be added.</remarks>
5171+
<exception cref="T:System.ArgumentNullException">
5172+
<paramref name="source" /> is <see langword="null" />.</exception>
51695173
</Docs>
51705174
</Member>
51715175
<Member MemberName="Reverse&lt;TSource&gt;">
@@ -6175,12 +6179,22 @@
61756179
<Parameter Name="count" Type="System.Int32" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
61766180
</Parameters>
61776181
<Docs>
6178-
<typeparam name="TSource">To be added.</typeparam>
6179-
<param name="source">To be added.</param>
6180-
<param name="count">To be added.</param>
6181-
<summary>To be added.</summary>
6182-
<returns>To be added.</returns>
6183-
<remarks>To be added.</remarks>
6182+
<typeparam name="TSource">The type of the elements in the queryable sequence.</typeparam>
6183+
<param name="source">A queryable sequence.</param>
6184+
<param name="count">The number of elements to omit from the end of the queryable sequence.</param>
6185+
<summary>Returns a new queryable sequence that contains the elements from <paramref name="source" /> with the last <paramref name="count" /> elements of the source queryable sequence omitted.</summary>
6186+
<returns>A new queryable sequence that contains the elements from <paramref name="source" /> minus <paramref name="count" /> elements from the end of the queryable sequence.</returns>
6187+
<remarks>
6188+
<format type="text/markdown"><![CDATA[
6189+
6190+
## Remarks
6191+
6192+
If `count` is not a positive number, this method returns an identical copy of the `source` queryable sequence.
6193+
6194+
]]></format>
6195+
</remarks>
6196+
<exception cref="T:System.ArgumentNullException">
6197+
<paramref name="source" /> is <see langword="null" />.</exception>
61846198
</Docs>
61856199
</Member>
61866200
<MemberGroup MemberName="SkipWhile&lt;TSource&gt;">
@@ -7695,12 +7709,22 @@
76957709
<Parameter Name="count" Type="System.Int32" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1" />
76967710
</Parameters>
76977711
<Docs>
7698-
<typeparam name="TSource">To be added.</typeparam>
7699-
<param name="source">To be added.</param>
7700-
<param name="count">To be added.</param>
7701-
<summary>To be added.</summary>
7702-
<returns>To be added.</returns>
7703-
<remarks>To be added.</remarks>
7712+
<typeparam name="TSource">The type of the elements in the queryable sequence.</typeparam>
7713+
<param name="source">A queryable sequence instance.</param>
7714+
<param name="count">The number of elements to take from the end of the queryable sequence.</param>
7715+
<summary>Returns a new queryable sequence that contains the last <paramref name="count" /> elements from <paramref name="source" />.</summary>
7716+
<returns>A new queryable sequence that contains the last <paramref name="count" /> elements from <paramref name="source" />.</returns>
7717+
<remarks>
7718+
<format type="text/markdown"><![CDATA[
7719+
7720+
## Remarks
7721+
7722+
If `count` is not a positive number, this method returns an empty queryable sequence.
7723+
7724+
]]></format>
7725+
</remarks>
7726+
<exception cref="T:System.ArgumentNullException">
7727+
<paramref name="source" /> is <see langword="null" />.</exception>
77047728
</Docs>
77057729
</Member>
77067730
<MemberGroup MemberName="TakeWhile&lt;TSource&gt;">

‎xml/System.Runtime.CompilerServices/ConditionalWeakTable`2.xml

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -562,9 +562,18 @@
562562
</ReturnValue>
563563
<Parameters />
564564
<Docs>
565-
<summary>To be added.</summary>
566-
<returns>To be added.</returns>
567-
<remarks>To be added.</remarks>
565+
<summary>Returns an enumerator that can be used to iterate through the <see cref="T:System.Runtime.CompilerServices.ConditionalWeakTable`2" /> table.</summary>
566+
<returns>An enumerator that can be used to iterate through the <see cref="T:System.Runtime.CompilerServices.ConditionalWeakTable`2" /> table.</returns>
567+
<remarks>
568+
<format type="text/markdown"><![CDATA[
569+
570+
## Remarks
571+
572+
The returned enumerator does not extend the lifetime of any object pairs in the table, other than the current one. It does not return entries that have already been collected or that were added after the enumerator was
573+
retrieved. Additionally, it may not return all entries that were present when the enumerator was retrieved, for example, entries that were collected or removed after the enumerator was retrieved but before they were enumerated.
574+
575+
]]></format>
576+
</remarks>
568577
</Docs>
569578
</Member>
570579
<Member MemberName="System.Collections.IEnumerable.GetEnumerator">
@@ -598,9 +607,20 @@
598607
</ReturnValue>
599608
<Parameters />
600609
<Docs>
601-
<summary>To be added.</summary>
602-
<returns>To be added.</returns>
603-
<remarks>To be added.</remarks>
610+
<summary>Returns an enumerator that can be used to iterate through the <see cref="T:System.Runtime.CompilerServices.ConditionalWeakTable`2" /> table.</summary>
611+
<returns>An enumerator that can be used to iterate through the <see cref="T:System.Runtime.CompilerServices.ConditionalWeakTable`2" /> table.</returns>
612+
<remarks>
613+
<format type="text/markdown"><![CDATA[
614+
615+
## Remarks
616+
617+
This member is an explicit interface member implementation. It can be used only when the <xref:System.Runtime.CompilerServices.ConditionalWeakTable%602> instance is cast to an <xref:System.Collections.IEnumerable> interface.
618+
619+
The returned enumerator does not extend the lifetime of any object pairs in the table, other than the current one. It does not return entries that have already been collected or that were added after the enumerator was
620+
retrieved. Additionally, it may not return all entries that were present when the enumerator was retrieved, for example, entries that were collected or removed after the enumerator was retrieved but before they were enumerated.
621+
622+
]]></format>
623+
</remarks>
604624
</Docs>
605625
</Member>
606626
<Member MemberName="TryGetValue">

‎xml/System/Action`1.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,8 +82,10 @@
8282
8383
## Examples
8484
The following example demonstrates the use of the <xref:System.Action%601> delegate to print the contents of a <xref:System.Collections.Generic.List%601> object. In this example, the `Print` method is used to display the contents of the list to the console. In addition, the C# example also demonstrates the use of anonymous methods to display the contents to the console. Note that the example does not explicitly declare an <xref:System.Action%601> variable. Instead, it passes a reference to a method that takes a single parameter and that does not return a value to the <xref:System.Collections.Generic.List%601.ForEach%2A?displayProperty=nameWithType> method, whose single parameter is an <xref:System.Action%601> delegate. Similarly, in the C# example, an <xref:System.Action%601> delegate is not explicitly instantiated because the signature of the anonymous method matches the signature of the <xref:System.Action%601> delegate that is expected by the <xref:System.Collections.Generic.List%601.ForEach%2A?displayProperty=nameWithType> method.
85-
86-
[!code-csharp[System.Action_PrintExample#01](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Action_PrintExample/cs/action.cs#01)]
85+
86+
[!INCLUDE[interactive-note](~/includes/csharp-interactive-note-some.md)]
87+
88+
[!code-csharp-interactive[System.Action_PrintExample#01](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.Action_PrintExample/cs/action.cs#01)]
8789
[!code-vb[System.Action_PrintExample#01](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Action_PrintExample/vb/action.vb#01)]
8890
8991
]]></format>

0 commit comments

Comments
 (0)