From aa11d6cbbfd00fa906616a62354c5f614a044bf5 Mon Sep 17 00:00:00 2001 From: Stephen Toub Date: Thu, 25 Jul 2019 22:04:39 -0400 Subject: [PATCH] Re-enable CA1200 (avoid cref tag prefixes) (dotnet/corefx#39773) * Re-enable CA1200 (avoid cref tag prefixes) Specifying the prefix prevents the compiler from validating what comes after it. * Fix netfx build Commit migrated from https://github.com/dotnet/corefx/commit/58a4d24eb808936f7dc61e68265e968291470b42 --- src/libraries/CodeAnalysis.ruleset | 1 - .../Collections/Generic/LargeArrayBuilder.cs | 4 +- .../src/System/Net/WebSockets/ManagedWebSocket.cs | 2 +- .../Collections/Concurrent/BlockingCollection.cs | 494 ++++----- .../System/Collections/Concurrent/ConcurrentBag.cs | 28 +- .../Collections/Concurrent/ConcurrentDictionary.cs | 294 +++--- .../Collections/Concurrent/ConcurrentStack.cs | 44 +- .../Collections/Concurrent/OrderablePartitioner.cs | 10 +- .../System/Collections/Concurrent/Partitioner.cs | 8 +- .../Collections/Concurrent/PartitionerStatic.cs | 16 +- .../Immutable/ImmutableArray_1.Minimal.cs | 2 +- .../Collections/Immutable/ImmutableDictionary_2.cs | 2 +- .../Immutable/ImmutableExtensions.Minimal.cs | 2 +- .../Collections/Immutable/ImmutableHashSet_1.cs | 2 +- .../Immutable/ImmutableSortedDictionary_2.cs | 2 +- .../Collections/Immutable/SortedInt32KeyNode.cs | 2 +- .../Hosting/CompositionScopeDefinition.cs | 4 +- .../Composition/Hosting/FilteredCatalog.cs | 4 +- .../src/System/ComponentModel/TypeDescriptor.cs | 20 - .../System.Data.Common/src/System/Data/DataSet.cs | 2 +- .../System.Data.Common/src/System/Data/DataView.cs | 2 +- .../System/Diagnostics/TextWriterTraceListener.cs | 4 +- .../src/System/IO/ErrorEventArgs.cs | 2 +- .../src/System/IO/ErrorEventHandler.cs | 4 +- .../src/System/Linq/ParallelEnumerable.cs | 1058 ++++++++++---------- .../System.Linq/src/System/Linq/Concat.cs | 4 +- .../System.Linq/src/System/Linq/Select.cs | 2 +- .../src/System/Linq/SingleLinkedNode.cs | 2 +- src/libraries/System.Linq/src/System/Linq/Where.cs | 4 +- .../System/Management/ManagementEventWatcher.cs | 4 +- .../Management/ManagementOperationWatcher.cs | 8 +- .../src/System/Buffers/ReadOnlySequence.cs | 4 +- .../src/System/Net/Sockets/AddressFamily.cs | 7 +- .../Utilities/ImmutableByteArrayInterop.cs | 4 +- .../InteropServices/WindowsRuntime/AsyncInfo.cs | 17 +- .../src/Base/DataflowBlock.cs | 10 +- .../src/Blocks/ActionBlock.cs | 6 +- .../src/Internal/ConcurrentQueue.cs | 46 +- .../src/Internal/IProducerConsumerCollection.cs | 6 +- .../src/System/Threading/Tasks/Parallel.cs | 752 +++++++------- .../System/Threading/Tasks/ParallelLoopState.cs | 10 +- .../src/System/Threading/Barrier.cs | 106 +- .../src/System/Threading/CountdownEvent.cs | 142 +-- 43 files changed, 1560 insertions(+), 1587 deletions(-) diff --git a/src/libraries/CodeAnalysis.ruleset b/src/libraries/CodeAnalysis.ruleset index 92aa3bc..8494e21 100644 --- a/src/libraries/CodeAnalysis.ruleset +++ b/src/libraries/CodeAnalysis.ruleset @@ -26,7 +26,6 @@ - diff --git a/src/libraries/Common/src/System/Collections/Generic/LargeArrayBuilder.cs b/src/libraries/Common/src/System/Collections/Generic/LargeArrayBuilder.cs index 5c823c5..fb00b3c 100644 --- a/src/libraries/Common/src/System/Collections/Generic/LargeArrayBuilder.cs +++ b/src/libraries/Common/src/System/Collections/Generic/LargeArrayBuilder.cs @@ -7,7 +7,7 @@ using System.Diagnostics; namespace System.Collections.Generic { /// - /// Represents a position within a . + /// Represents a position within a . /// [DebuggerDisplay("{DebuggerDisplay,nq}")] internal readonly struct CopyPosition @@ -27,7 +27,7 @@ namespace System.Collections.Generic } /// - /// Represents a position at the start of a . + /// Represents a position at the start of a . /// public static CopyPosition Start => default(CopyPosition); diff --git a/src/libraries/Common/src/System/Net/WebSockets/ManagedWebSocket.cs b/src/libraries/Common/src/System/Net/WebSockets/ManagedWebSocket.cs index 3da37bc..1337614 100644 --- a/src/libraries/Common/src/System/Net/WebSockets/ManagedWebSocket.cs +++ b/src/libraries/Common/src/System/Net/WebSockets/ManagedWebSocket.cs @@ -614,7 +614,7 @@ namespace System.Net.WebSockets /// /// The buffer into which payload data should be written. /// The CancellationToken used to cancel the websocket. - /// Used to get the result. Allows the same method to be used with both and . + /// Used to get the result. Allows the same method to be used with both WebSocketReceiveResult and ValueWebSocketReceiveResult. /// Information about the received message. private async ValueTask ReceiveAsyncPrivate( Memory payloadBuffer, diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/BlockingCollection.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/BlockingCollection.cs index 9da52a7..bca24f1 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/BlockingCollection.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/BlockingCollection.cs @@ -22,21 +22,21 @@ namespace System.Collections.Concurrent { /// /// Provides blocking and bounding capabilities for thread-safe collections that - /// implement . + /// implement . /// /// - /// represents a collection + /// represents a collection /// that allows for thread-safe adding and removing of data. - /// is used as a wrapper - /// for an instance, allowing + /// is used as a wrapper + /// for an instance, allowing /// removal attempts from the collection to block until data is available to be removed. Similarly, - /// a can be created to enforce + /// a can be created to enforce /// an upper-bound on the number of data elements allowed in the - /// ; addition attempts to the + /// ; addition attempts to the /// collection may then block until space is available to store the added items. In this manner, - /// is similar to a traditional + /// is similar to a traditional /// blocking queue data structure, except that the underlying data storage mechanism is abstracted - /// away as an . + /// away as an . /// /// Specifies the type of elements in the collection. [DebuggerTypeProxy(typeof(BlockingCollectionDebugView<>))] @@ -56,10 +56,10 @@ namespace System.Collections.Concurrent private const int COMPLETE_ADDING_ON_MASK = unchecked((int)0x80000000); #region Properties - /// Gets the bounded capacity of this instance. + /// Gets the bounded capacity of this instance. /// The bounded capacity of this collection, or -1 if no bound was supplied. - /// The has been disposed. + /// The has been disposed. public int BoundedCapacity { get @@ -69,10 +69,10 @@ namespace System.Collections.Concurrent } } - /// Gets whether this has been marked as complete for adding. + /// Gets whether this has been marked as complete for adding. /// Whether this collection has been marked as complete for adding. - /// The has been disposed. + /// The has been disposed. public bool IsAddingCompleted { get @@ -82,10 +82,10 @@ namespace System.Collections.Concurrent } } - /// Gets whether this has been marked as complete for adding and is empty. + /// Gets whether this has been marked as complete for adding and is empty. /// Whether this collection has been marked as complete for adding and is empty. - /// The has been disposed. + /// The has been disposed. public bool IsCompleted { get @@ -95,10 +95,10 @@ namespace System.Collections.Concurrent } } - /// Gets the number of items contained in the . - /// The number of items contained in the . - /// The has been disposed. + /// Gets the number of items contained in the . + /// The number of items contained in the . + /// The has been disposed. public int Count { get @@ -108,9 +108,9 @@ namespace System.Collections.Concurrent } } - /// Gets a value indicating whether access to the is synchronized. - /// The has been disposed. + /// Gets a value indicating whether access to the is synchronized. + /// The has been disposed. bool ICollection.IsSynchronized { get @@ -122,9 +122,9 @@ namespace System.Collections.Concurrent /// /// Gets an object that can be used to synchronize access to the . This property is not supported. + /// cref="System.Collections.ICollection"/>. This property is not supported. /// - /// The SyncRoot property is not supported. + /// The SyncRoot property is not supported. object ICollection.SyncRoot { get @@ -136,7 +136,7 @@ namespace System.Collections.Concurrent /// Initializes a new instance of the - /// + /// /// class without an upper-bound. /// /// @@ -148,11 +148,11 @@ namespace System.Collections.Concurrent } /// Initializes a new instance of the + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> /// class with the specified upper-bound. /// /// The bounded size of the collection. - /// The is + /// The is /// not a positive value. /// /// The default underlying collection is a ConcurrentQueue<T>. @@ -162,14 +162,14 @@ namespace System.Collections.Concurrent { } - /// Initializes a new instance of the + /// Initializes a new instance of the /// class with the specified upper-bound and using the provided - /// as its underlying data store. + /// as its underlying data store. /// The collection to use as the underlying data store. /// The bounded size of the collection. - /// The argument is + /// The argument is /// null. - /// The is not a positive value. + /// The is not a positive value. /// The supplied contains more values /// than is permitted by . public BlockingCollection(IProducerConsumerCollection collection, int boundedCapacity) @@ -192,11 +192,11 @@ nameof(boundedCapacity), boundedCapacity, Initialize(collection, boundedCapacity, count); } - /// Initializes a new instance of the + /// Initializes a new instance of the /// class without an upper-bound and using the provided - /// as its underlying data store. + /// as its underlying data store. /// The collection to use as the underlying data store. - /// The argument is + /// The argument is /// null. public BlockingCollection(IProducerConsumerCollection collection) { @@ -237,18 +237,18 @@ nameof(boundedCapacity), boundedCapacity, /// - /// Adds the item to the . + /// Adds the item to the . /// /// The item to be added to the collection. The value can be a null reference. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// The underlying collection didn't accept the item. + /// The has been disposed. + /// The underlying collection didn't accept the item. /// /// If a bounded capacity was specified when this instance of - /// was initialized, + /// was initialized, /// a call to Add may block until space is available to store the provided item. /// public void Add(T item) @@ -263,22 +263,22 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Adds the item to the . + /// Adds the item to the . /// A is thrown if the is /// canceled. /// /// The item to be added to the collection. The value can be a null reference. /// A cancellation token to observe. /// If the is canceled. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// The underlying collection didn't accept the item. + /// The has been disposed. + /// The underlying collection didn't accept the item. /// /// If a bounded capacity was specified when this instance of - /// was initialized, + /// was initialized, /// a call to may block until space is available to store the provided item. /// public void Add(T item, CancellationToken cancellationToken) @@ -293,23 +293,23 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to add the specified item to the . + /// Attempts to add the specified item to the . /// /// The item to be added to the collection. /// true if the could be added; otherwise, false. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// The underlying collection didn't accept the item. + /// The has been disposed. + /// The underlying collection didn't accept the item. public bool TryAdd(T item) { return TryAddWithNoTimeValidation(item, 0, new CancellationToken()); } /// - /// Attempts to add the specified item to the . + /// Attempts to add the specified item to the . /// /// The item to be added to the collection. /// A that represents the number of milliseconds @@ -317,15 +317,15 @@ nameof(boundedCapacity), boundedCapacity, /// /// true if the could be added to the collection within /// the alloted time; otherwise, false. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// is a negative number + /// The has been disposed. + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than /// . - /// The underlying collection didn't accept the item. + /// The underlying collection didn't accept the item. public bool TryAdd(T item, TimeSpan timeout) { ValidateTimeout(timeout); @@ -333,21 +333,21 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to add the specified item to the . + /// Attempts to add the specified item to the . /// /// The item to be added to the collection. /// The number of milliseconds to wait, or (-1) to wait indefinitely. /// true if the could be added to the collection within /// the alloted time; otherwise, false. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// is a + /// The has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// The underlying collection didn't accept the item. + /// The underlying collection didn't accept the item. public bool TryAdd(T item, int millisecondsTimeout) { ValidateMillisecondsTimeout(millisecondsTimeout); @@ -355,7 +355,7 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to add the specified item to the . + /// Attempts to add the specified item to the . /// A is thrown if the is /// canceled. /// @@ -366,14 +366,14 @@ nameof(boundedCapacity), boundedCapacity, /// true if the could be added to the collection within /// the alloted time; otherwise, false. /// If the is canceled. - /// The has been marked + /// The has been marked /// as complete with regards to additions. - /// The has been disposed. - /// is a + /// The has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// The underlying collection didn't accept the item. + /// The underlying collection didn't accept the item. public bool TryAdd(T item, int millisecondsTimeout, CancellationToken cancellationToken) { ValidateMillisecondsTimeout(millisecondsTimeout); @@ -394,7 +394,7 @@ nameof(boundedCapacity), boundedCapacity, /// the collection has already been marked /// as complete with regards to additions. /// If the collection has been disposed. - /// The underlying collection didn't accept the item. + /// The underlying collection didn't accept the item. private bool TryAddWithNoTimeValidation(T item, int millisecondsTimeout, CancellationToken cancellationToken) { CheckDisposed(); @@ -522,16 +522,16 @@ nameof(boundedCapacity), boundedCapacity, return waitForSemaphoreWasSuccessful; } - /// Takes an item from the . + /// Takes an item from the . /// The item removed from the collection. - /// The is empty and has been marked + /// The is empty and has been marked /// as complete with regards to additions. - /// The has been disposed. - /// The underlying collection was modified + /// The has been disposed. + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. /// A call to may block until an item is available to be removed. public T Take() { @@ -545,17 +545,17 @@ nameof(boundedCapacity), boundedCapacity, return item; } - /// Takes an item from the . + /// Takes an item from the . /// The item removed from the collection. - /// If the is + /// If the is /// canceled or the is empty and has been marked + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> is empty and has been marked /// as complete with regards to additions. - /// The has been disposed. - /// The underlying collection was modified + /// The has been disposed. + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. /// A call to may block until an item is available to be removed. public T Take(CancellationToken cancellationToken) { @@ -570,22 +570,22 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to remove an item from the . + /// Attempts to remove an item from the . /// /// The item removed from the collection. /// true if an item could be removed; otherwise, false. - /// The has been disposed. - /// The underlying collection was modified + /// The has been disposed. + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. public bool TryTake([MaybeNullWhen(false)] out T item) { return TryTake(out item, 0, CancellationToken.None); } /// - /// Attempts to remove an item from the . + /// Attempts to remove an item from the . /// /// The item removed from the collection. /// A that represents the number of milliseconds @@ -593,14 +593,14 @@ nameof(boundedCapacity), boundedCapacity, /// /// true if an item could be removed from the collection within /// the alloted time; otherwise, false. - /// The has been disposed. - /// is a negative number + /// The has been disposed. + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than /// . - /// The underlying collection was modified + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. public bool TryTake([MaybeNullWhen(false)] out T item, TimeSpan timeout) { ValidateTimeout(timeout); @@ -608,20 +608,20 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to remove an item from the . + /// Attempts to remove an item from the . /// /// The item removed from the collection. /// The number of milliseconds to wait, or (-1) to wait indefinitely. /// true if an item could be removed from the collection within /// the alloted time; otherwise, false. - /// The has been disposed. - /// is a + /// The has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// The underlying collection was modified + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. public bool TryTake([MaybeNullWhen(false)] out T item, int millisecondsTimeout) { ValidateMillisecondsTimeout(millisecondsTimeout); @@ -629,7 +629,7 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Attempts to remove an item from the . + /// Attempts to remove an item from the . /// A is thrown if the is /// canceled. /// @@ -640,13 +640,13 @@ nameof(boundedCapacity), boundedCapacity, /// true if an item could be removed from the collection within /// the alloted time; otherwise, false. /// If the is canceled. - /// The has been disposed. - /// is a + /// The has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// The underlying collection was modified + /// The underlying collection was modified /// outside of this instance. + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. public bool TryTake([MaybeNullWhen(false)] out T item, int millisecondsTimeout, CancellationToken cancellationToken) { ValidateMillisecondsTimeout(millisecondsTimeout); @@ -767,24 +767,24 @@ nameof(boundedCapacity), boundedCapacity, /// /// Adds the specified item to any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item to be added to one of the collections. /// The index of the collection in the array to which the item was added. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one of the instances has been disposed. + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// /// If a bounded capacity was specified when all of the - /// instances were initialized, + /// instances were initialized, /// a call to AddToAny may block until space is available in one of the collections /// to store the provided item. /// @@ -805,7 +805,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Adds the specified item to any one of the specified - /// instances. + /// instances. /// A is thrown if the is /// canceled. /// @@ -814,19 +814,19 @@ nameof(boundedCapacity), boundedCapacity, /// A cancellation token to observe. /// The index of the collection in the array to which the item was added. /// If the is canceled. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one of the instances has been disposed. + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// /// If a bounded capacity was specified when all of the - /// instances were initialized, + /// instances were initialized, /// a call to AddToAny may block until space is available in one of the collections /// to store the provided item. /// @@ -847,21 +847,21 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to add the specified item to any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item to be added to one of the collections. /// The index of the collection in the /// array to which the item was added, or -1 if the item could not be added. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one of the instances has been disposed. + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. public static int TryAddToAny(BlockingCollection[] collections, T item) { @@ -870,7 +870,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to add the specified item to any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item to be added to one of the collections. @@ -879,18 +879,18 @@ nameof(boundedCapacity), boundedCapacity, /// /// The index of the collection in the /// array to which the item was added, or -1 if the item could not be added. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// is a negative number + /// At least one of the instances has been disposed. + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than /// . - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. public static int TryAddToAny(BlockingCollection[] collections, T item, TimeSpan timeout) { @@ -900,24 +900,24 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to add the specified item to any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item to be added to one of the collections. /// The number of milliseconds to wait, or (-1) to wait indefinitely. /// The index of the collection in the /// array to which the item was added, or -1 if the item could not be added. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// is a + /// At least one of the instances has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. public static int TryAddToAny(BlockingCollection[] collections, T item, int millisecondsTimeout) { @@ -927,7 +927,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to add the specified item to any one of the specified - /// instances. + /// instances. /// A is thrown if the is /// canceled. /// @@ -939,17 +939,17 @@ nameof(boundedCapacity), boundedCapacity, /// array to which the item was added, or -1 if the item could not be added. /// A cancellation token to observe. /// If the is canceled. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element, or at least one of collections has been /// marked as complete for adding. - /// At least one of the instances has been disposed. - /// is a + /// At least one of the instances has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// At least one underlying collection didn't accept the item. - /// The count of is greater than the maximum size of + /// At least one underlying collection didn't accept the item. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. public static int TryAddToAny(BlockingCollection[] collections, T item, int millisecondsTimeout, CancellationToken cancellationToken) { @@ -1149,22 +1149,22 @@ nameof(boundedCapacity), boundedCapacity, } /// /// Takes an item from any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item removed from one of the collections. /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// At least one of the underlying collections was modified + /// At least one of the instances has been disposed. + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TakeFromAny may block until an item is available to be removed. public static int TakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item) @@ -1174,7 +1174,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Takes an item from any one of the specified - /// instances. + /// instances. /// A is thrown if the is /// canceled. /// @@ -1183,17 +1183,17 @@ nameof(boundedCapacity), boundedCapacity, /// A cancellation token to observe. /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. - /// The argument is + /// The argument is /// null. /// If the is canceled. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// At least one of the underlying collections was modified + /// At least one of the instances has been disposed. + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TakeFromAny may block until an item is available to be removed. public static int TakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item, CancellationToken cancellationToken) @@ -1206,22 +1206,22 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to remove an item from any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item removed from one of the collections. /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// At least one of the underlying collections was modified + /// At least one of the instances has been disposed. + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TryTakeFromAny may block until an item is available to be removed. public static int TryTakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item) @@ -1231,7 +1231,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to remove an item from any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item removed from one of the collections. @@ -1240,19 +1240,19 @@ nameof(boundedCapacity), boundedCapacity, /// /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// is a negative number + /// At least one of the instances has been disposed. + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than /// . - /// At least one of the underlying collections was modified + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TryTakeFromAny may block until an item is available to be removed. public static int TryTakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item, TimeSpan timeout) @@ -1263,7 +1263,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to remove an item from any one of the specified - /// instances. + /// instances. /// /// The array of collections. /// The item removed from one of the collections. @@ -1271,18 +1271,18 @@ nameof(boundedCapacity), boundedCapacity, /// cref="System.Threading.Timeout.Infinite"/> (-1) to wait indefinitely. /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// is a + /// At least one of the instances has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// At least one of the underlying collections was modified + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TryTakeFromAny may block until an item is available to be removed. public static int TryTakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item, int millisecondsTimeout) @@ -1293,7 +1293,7 @@ nameof(boundedCapacity), boundedCapacity, /// /// Attempts to remove an item from any one of the specified - /// instances. + /// instances. /// A is thrown if the is /// canceled. /// @@ -1305,18 +1305,18 @@ nameof(boundedCapacity), boundedCapacity, /// The index of the collection in the array from which /// the item was removed, or -1 if an item could not be removed. /// If the is canceled. - /// The argument is + /// The argument is /// null. - /// The argument is + /// The argument is /// a 0-length array or contains a null element. - /// At least one of the instances has been disposed. - /// is a + /// At least one of the instances has been disposed. + /// is a /// negative number other than -1, which represents an infinite time-out. - /// At least one of the underlying collections was modified + /// At least one of the underlying collections was modified /// outside of its instance. - /// The count of is greater than the maximum size of + /// cref="System.Collections.Concurrent.BlockingCollection{T}"/> instance. + /// The count of is greater than the maximum size of /// 62 for STA and 63 for MTA. /// A call to TryTakeFromAny may block until an item is available to be removed. public static int TryTakeFromAny(BlockingCollection[] collections, [MaybeNull] out T item, int millisecondsTimeout, CancellationToken cancellationToken) @@ -1459,15 +1459,15 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Marks the instances + /// Marks the instances /// as not accepting any more additions. /// /// /// After a collection has been marked as complete for adding, adding to the collection is not permitted /// and attempts to remove from the collection will not wait when the collection is empty. /// - /// The has been disposed. + /// The has been disposed. public void CompleteAdding() { CheckDisposed(); @@ -1519,7 +1519,7 @@ nameof(boundedCapacity), boundedCapacity, /// - /// Releases resources used by the instance. + /// Releases resources used by the instance. /// public void Dispose() { @@ -1528,7 +1528,7 @@ nameof(boundedCapacity), boundedCapacity, } /// - /// Releases resources used by the instance. + /// Releases resources used by the instance. /// /// Whether being disposed explicitly (true) or due to a finalizer (false). protected virtual void Dispose(bool disposing) @@ -1546,10 +1546,10 @@ nameof(boundedCapacity), boundedCapacity, } } - /// Copies the items from the instance into a new array. + /// Copies the items from the instance into a new array. /// An array containing copies of the elements of the collection. - /// The has been disposed. + /// The has been disposed. /// /// The copied elements are not removed from the collection. /// @@ -1559,38 +1559,38 @@ nameof(boundedCapacity), boundedCapacity, return _collection.ToArray(); } - /// Copies all of the items in the instance + /// Copies all of the items in the instance /// to a compatible one-dimensional array, starting at the specified index of the target array. /// /// The one-dimensional array that is the destination of the elements copied from - /// the instance. The array must have zero-based indexing. + /// the instance. The array must have zero-based indexing. /// The zero-based index in at which copying begins. - /// The argument is + /// The argument is /// null. /// The argument is less than zero. /// The argument is equal to or greater /// than the length of the . - /// The has been disposed. + /// The has been disposed. public void CopyTo(T[] array, int index) { ((ICollection)this).CopyTo(array, index); } - /// Copies all of the items in the instance + /// Copies all of the items in the instance /// to a compatible one-dimensional array, starting at the specified index of the target array. /// /// The one-dimensional array that is the destination of the elements copied from - /// the instance. The array must have zero-based indexing. + /// the instance. The array must have zero-based indexing. /// The zero-based index in at which copying begins. - /// The argument is + /// The argument is /// null. /// The argument is less than zero. /// The argument is equal to or greater /// than the length of the , the array is multidimensional, or the type parameter for the collection /// cannot be cast automatically to the type of the destination array. - /// The has been disposed. + /// The has been disposed. void ICollection.CopyTo(Array array, int index) { CheckDisposed(); @@ -1629,23 +1629,23 @@ nameof(boundedCapacity), boundedCapacity, } } - /// Provides a consuming for items in the collection. - /// An that removes and returns items from the collection. - /// The has been disposed. + /// Provides a consuming for items in the collection. + /// An that removes and returns items from the collection. + /// The has been disposed. public IEnumerable GetConsumingEnumerable() { return GetConsumingEnumerable(CancellationToken.None); } - /// Provides a consuming for items in the collection. + /// Provides a consuming for items in the collection. /// Calling MoveNext on the returned enumerable will block if there is no data available, or will /// throw an if the is canceled. /// /// A cancellation token to observe. - /// An that removes and returns items from the collection. - /// The has been disposed. + /// An that removes and returns items from the collection. + /// The has been disposed. /// If the is canceled. public IEnumerable GetConsumingEnumerable(CancellationToken cancellationToken) { @@ -1671,20 +1671,20 @@ nameof(boundedCapacity), boundedCapacity, } } - /// Provides an for items in the collection. - /// An for the items in the collection. - /// The has been disposed. + /// Provides an for items in the collection. + /// An for the items in the collection. + /// The has been disposed. IEnumerator IEnumerable.GetEnumerator() { CheckDisposed(); return _collection.GetEnumerator(); } - /// Provides an for items in the collection. - /// An for the items in the collection. - /// The has been disposed. + /// Provides an for items in the collection. + /// An for the items in the collection. + /// The has been disposed. IEnumerator IEnumerable.GetEnumerator() { return ((IEnumerable)this).GetEnumerator(); diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentBag.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentBag.cs index 0146c9f..91ec42f 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentBag.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentBag.cs @@ -251,13 +251,13 @@ namespace System.Collections.Concurrent /// /// Copies the elements to an existing - /// one-dimensional Array, starting at the specified array + /// one-dimensional Array, starting at the specified array /// index. /// - /// The one-dimensional Array that is the + /// The one-dimensional Array that is the /// destination of the elements copied from the /// . The Array must have zero-based indexing. + /// cref="System.Array">Array must have zero-based indexing. /// The zero-based index in at which copying /// begins. /// is a null reference (Nothing in @@ -330,14 +330,14 @@ namespace System.Collections.Concurrent } /// - /// Copies the elements of the to an , starting at a particular - /// index. + /// Copies the elements of the to an , starting at a particular + /// index. /// - /// The one-dimensional Array that is the + /// The one-dimensional Array that is the /// destination of the elements copied from the /// . The Array must have zero-based indexing. + /// cref="System.Array">Array must have zero-based indexing. /// The zero-based index in at which copying /// begins. /// is a null reference (Nothing in @@ -348,10 +348,10 @@ namespace System.Collections.Concurrent /// is multidimensional. -or- /// does not have zero-based indexing. -or- /// is equal to or greater than the length of the - /// -or- The number of elements in the source is + /// -or- The number of elements in the source is /// greater than the available space from to the end of the destination /// . -or- The type of the source cannot be cast automatically to the type of the + /// cref="System.Collections.ICollection"/> cannot be cast automatically to the type of the /// destination . /// void ICollection.CopyTo(Array array, int index) @@ -583,19 +583,19 @@ namespace System.Collections.Concurrent } /// - /// Gets a value indicating whether access to the is + /// Gets a value indicating whether access to the is /// synchronized with the SyncRoot. /// - /// true if access to the is synchronized + /// true if access to the is synchronized /// with the SyncRoot; otherwise, false. For , this property always /// returns false. bool ICollection.IsSynchronized => false; /// /// Gets an object that can be used to synchronize access to the . This property is not supported. + /// cref="System.Collections.ICollection"/>. This property is not supported. /// - /// The SyncRoot property is not supported. + /// The SyncRoot property is not supported. object ICollection.SyncRoot { get { throw new NotSupportedException(SR.ConcurrentCollection_SyncRoot_NotSupported); } diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentDictionary.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentDictionary.cs index f51cd77..b9a7e52 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentDictionary.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentDictionary.cs @@ -129,51 +129,51 @@ namespace System.Collections.Concurrent /// The initial number of elements that the /// can contain. - /// is + /// is /// less than 1. - /// is less than + /// is less than /// 0. public ConcurrentDictionary(int concurrencyLevel, int capacity) : this(concurrencyLevel, capacity, false, null) { } /// /// Initializes a new instance of the /// class that contains elements copied from the specified , has the default concurrency + /// cref="System.Collections.Generic.IEnumerable{T}"/>, has the default concurrency /// level, has the default initial capacity, and uses the default comparer for the key type. /// /// The whose elements are copied to + /// cref="System.Collections.Generic.IEnumerable{T}"/> whose elements are copied to /// the new /// . - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// contains one or more + /// contains one or more /// duplicate keys. public ConcurrentDictionary(IEnumerable> collection) : this(collection, null) { } /// /// Initializes a new instance of the /// class that is empty, has the specified concurrency level and capacity, and uses the specified - /// . + /// . /// - /// The + /// The /// implementation to use when comparing keys. public ConcurrentDictionary(IEqualityComparer? comparer) : this(DefaultConcurrencyLevel, DefaultCapacity, true, comparer) { } /// /// Initializes a new instance of the /// class that contains elements copied from the specified , has the default concurrency level, has the default + /// cref="System.Collections.IEnumerable"/>, has the default concurrency level, has the default /// initial capacity, and uses the specified - /// . + /// . /// /// The whose elements are copied to + /// cref="System.Collections.Generic.IEnumerable{T}"/> whose elements are copied to /// the new /// . - /// The + /// The /// implementation to use when comparing keys. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). public ConcurrentDictionary(IEnumerable> collection, IEqualityComparer? comparer) : this(comparer) @@ -185,23 +185,23 @@ namespace System.Collections.Concurrent /// /// Initializes a new instance of the - /// class that contains elements copied from the specified , + /// class that contains elements copied from the specified , /// has the specified concurrency level, has the specified initial capacity, and uses the specified - /// . + /// . /// /// The estimated number of threads that will update the /// concurrently. - /// The whose elements are copied to the new + /// The whose elements are copied to the new /// . - /// The implementation to use + /// The implementation to use /// when comparing keys. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// is less than 1. /// - /// contains one or more duplicate keys. + /// contains one or more duplicate keys. public ConcurrentDictionary( int concurrencyLevel, IEnumerable> collection, IEqualityComparer? comparer) : this(concurrencyLevel, DefaultCapacity, false, comparer) @@ -233,16 +233,16 @@ namespace System.Collections.Concurrent /// /// Initializes a new instance of the /// class that is empty, has the specified concurrency level, has the specified initial capacity, and - /// uses the specified . + /// uses the specified . /// /// The estimated number of threads that will update the /// concurrently. /// The initial number of elements that the /// can contain. - /// The + /// The /// implementation to use when comparing keys. - /// + /// /// is less than 1. -or- /// is less than 0. /// @@ -294,9 +294,9 @@ namespace System.Collections.Concurrent /// true if the key/value pair was added to the /// successfully; otherwise, false. - /// is null reference + /// is null reference /// (Nothing in Visual Basic). - /// The + /// The /// contains too many elements. public bool TryAdd(TKey key, TValue value) { @@ -313,7 +313,7 @@ namespace System.Collections.Concurrent /// TValue}"/>. /// true if the contains an element with /// the specified key; otherwise, false. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). public bool ContainsKey(TKey key) { @@ -333,7 +333,7 @@ namespace System.Collections.Concurrent /// name="TValue"/> /// if the operation failed. /// true if an object was removed successfully; otherwise, false. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). public bool TryRemove(TKey key, [MaybeNullWhen(false)] out TValue value) { @@ -421,7 +421,7 @@ namespace System.Collections.Concurrent /// , if the operation failed. /// true if the key was found in the ; /// otherwise, false. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). public bool TryGetValue(TKey key, [MaybeNullWhen(false)] out TValue value) { @@ -470,7 +470,7 @@ namespace System.Collections.Concurrent /// true if the value with was equal to and replaced with ; otherwise, /// false. - /// is a null + /// is a null /// reference. public bool TryUpdate(TKey key, TValue newValue, TValue comparisonValue) { @@ -492,7 +492,7 @@ namespace System.Collections.Concurrent /// true if the value with was equal to and replaced with ; otherwise, /// false. - /// is a null + /// is a null /// reference. private bool TryUpdateInternal(TKey key, int hashcode, TValue newValue, TValue comparisonValue) { @@ -580,24 +580,24 @@ namespace System.Collections.Concurrent } /// - /// Copies the elements of the to an array of - /// type , starting at the + /// Copies the elements of the to an array of + /// type , starting at the /// specified array index. /// /// The one-dimensional array of type + /// cref="System.Collections.Generic.KeyValuePair{TKey,TValue}"/> /// that is the destination of the elements copied from the . The array must have zero-based indexing. + /// cref="System.Collections.Generic.KeyValuePair{TKey,TValue}"/> elements copied from the . The array must have zero-based indexing. /// The zero-based index in at which copying /// begins. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is less than + /// is less than /// 0. - /// is equal to or greater than + /// is equal to or greater than /// the length of the . -or- The number of elements in the source + /// cref="System.Collections.ICollection"/> /// is greater than the available space from to the end of the destination /// . void ICollection>.CopyTo(KeyValuePair[] array, int index) @@ -863,11 +863,11 @@ namespace System.Collections.Concurrent /// The key of the value to get or set. /// The value associated with the specified key. If the specified key is not found, a get /// operation throws a - /// , and a set operation creates a new + /// , and a set operation creates a new /// element with the specified key. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The property is retrieved and + /// The property is retrieved and /// /// does not exist in the collection. public TValue this[TKey key] @@ -929,7 +929,7 @@ namespace System.Collections.Concurrent /// Gets the number of key/value pairs contained in the . /// - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The number of key/value pairs contained in the . @@ -961,7 +961,7 @@ namespace System.Collections.Concurrent /// cref="ConcurrentDictionary{TKey,TValue}"/>. Should only be used after all locks /// have been acquired. /// - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The number of key/value pairs contained in the . @@ -987,11 +987,11 @@ namespace System.Collections.Concurrent /// /// The key of the element to add. /// The function used to generate a value for the key - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The value for the key. This will be either the existing value for the key if the /// key is already in the dictionary, or the new value for the key as returned by valueFactory @@ -1018,11 +1018,11 @@ namespace System.Collections.Concurrent /// The key of the element to add. /// The function used to generate a value for the key /// An argument value to pass into . - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The value for the key. This will be either the existing value for the key if the /// key is already in the dictionary, or the new value for the key as returned by valueFactory @@ -1048,9 +1048,9 @@ namespace System.Collections.Concurrent /// /// The key of the element to add. /// the value to be added, if the key does not already exist - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The value for the key. This will be either the existing value for the key if the /// key is already in the dictionary, or the new value if the key was not in the dictionary. @@ -1078,13 +1078,13 @@ namespace System.Collections.Concurrent /// The function used to generate a new value for an existing key /// based on the key's existing value /// An argument to pass into and . - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The new value for the key. This will be either be the result of addValueFactory (if the key was /// absent) or the result of updateValueFactory (if the key was present). @@ -1130,13 +1130,13 @@ namespace System.Collections.Concurrent /// The function used to generate a value for an absent key /// The function used to generate a new value for an existing key /// based on the key's existing value - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The new value for the key. This will be either the result of addValueFactory (if the key was /// absent) or the result of updateValueFactory (if the key was present). @@ -1181,11 +1181,11 @@ namespace System.Collections.Concurrent /// The value to be added for an absent key /// The function used to generate a new value for an existing key based on /// the key's existing value - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. /// The new value for the key. This will be either the value of addValue (if the key was /// absent) or the result of updateValueFactory (if the key was present). @@ -1275,15 +1275,15 @@ namespace System.Collections.Concurrent /// /// Adds the specified key and value to the . + /// cref="System.Collections.Generic.IDictionary{TKey,TValue}"/>. /// /// The object to use as the key of the element to add. /// The object to use as the value of the element to add. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. - /// + /// /// An element with the same key already exists in the . void IDictionary.Add(TKey key, TValue value) @@ -1296,15 +1296,15 @@ namespace System.Collections.Concurrent /// /// Removes the element with the specified key from the . + /// cref="System.Collections.Generic.IDictionary{TKey,TValue}"/>. /// /// The key of the element to remove. /// true if the element is successfully remove; otherwise false. This method also returns /// false if /// was not found in the original . + /// cref="System.Collections.Generic.IDictionary{TKey,TValue}"/>. /// - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). bool IDictionary.Remove(TKey key) { @@ -1314,21 +1314,21 @@ namespace System.Collections.Concurrent /// /// Gets a collection containing the keys in the . + /// cref="System.Collections.Generic.Dictionary{TKey,TValue}"/>. /// - /// An containing the keys in the - /// . + /// An containing the keys in the + /// . public ICollection Keys { get { return GetKeys(); } } /// - /// Gets an containing the keys of - /// the . + /// Gets an containing the keys of + /// the . /// - /// An containing the keys of - /// the . + /// An containing the keys of + /// the . IEnumerable IReadOnlyDictionary.Keys { get { return GetKeys(); } @@ -1336,22 +1336,22 @@ namespace System.Collections.Concurrent /// /// Gets a collection containing the values in the . + /// cref="System.Collections.Generic.Dictionary{TKey,TValue}"/>. /// - /// An containing the values in + /// An containing the values in /// the - /// . + /// . public ICollection Values { get { return GetValues(); } } /// - /// Gets an containing the values - /// in the . + /// Gets an containing the values + /// in the . /// - /// An containing the - /// values in the . + /// An containing the + /// values in the . IEnumerable IReadOnlyDictionary.Values { get { return GetValues(); } @@ -1361,33 +1361,33 @@ namespace System.Collections.Concurrent #region ICollection> Members /// - /// Adds the specified value to the + /// Adds the specified value to the /// with the specified key. /// - /// The + /// The /// structure representing the key and value to add to the . - /// The of . + /// The of is null. - /// The + /// The /// contains too many elements. - /// An element with the same key already exists in the - /// + /// An element with the same key already exists in the + /// void ICollection>.Add(KeyValuePair keyValuePair) { ((IDictionary)this).Add(keyValuePair.Key, keyValuePair.Value); } /// - /// Determines whether the + /// Determines whether the /// contains a specific key and value. /// - /// The + /// The /// structure to locate in the . + /// cref="System.Collections.Generic.ICollection{TValue}"/>. /// true if the is found in the ; otherwise, false. + /// cref="System.Collections.Generic.ICollection{T}"/>; otherwise, false. bool ICollection>.Contains(KeyValuePair keyValuePair) { TValue value; @@ -1401,9 +1401,9 @@ namespace System.Collections.Concurrent /// /// Gets a value indicating whether the dictionary is read-only. /// - /// true if the is + /// true if the is /// read-only; otherwise, false. For , this property always returns + /// cref="System.Collections.Generic.Dictionary{TKey,TValue}"/>, this property always returns /// false. bool ICollection>.IsReadOnly { @@ -1414,12 +1414,12 @@ namespace System.Collections.Concurrent /// Removes a key and value from the dictionary. /// /// The + /// cref="System.Collections.Generic.KeyValuePair{TKey,TValue}"/> /// structure representing the key and value to remove from the . + /// cref="System.Collections.Generic.Dictionary{TKey,TValue}"/>. /// true if the key and value represented by is successfully /// found and removed; otherwise, false. - /// The Key property of The Key property of is a null reference (Nothing in Visual Basic). bool ICollection>.Remove(KeyValuePair keyValuePair) { @@ -1456,17 +1456,17 @@ namespace System.Collections.Concurrent /// /// The object to use as the key. /// The object to use as the value. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// The dictionary contains too many + /// The dictionary contains too many /// elements. - /// + /// /// is of a type that is not assignable to the key type of the . -or- + /// name="TKey"/> of the . -or- /// is of a type that is not assignable to , - /// the type of values in the . + /// the type of values in the . /// -or- A value with the same key already exists in the . + /// cref="System.Collections.Generic.Dictionary{TKey,TValue}"/>. /// void IDictionary.Add(object key, object? value) { @@ -1478,14 +1478,14 @@ namespace System.Collections.Concurrent } /// - /// Gets whether the contains an + /// Gets whether the contains an /// element with the specified key. /// /// The key to locate in the . - /// true if the contains + /// cref="System.Collections.IDictionary"/>. + /// true if the contains /// an element with the specified key; otherwise, false. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). bool IDictionary.Contains(object key) { @@ -1494,10 +1494,10 @@ namespace System.Collections.Concurrent return (key is TKey) && this.ContainsKey((TKey)key); } - /// Provides an for the - /// . - /// An for the . + /// Provides an for the + /// . + /// An for the . IDictionaryEnumerator IDictionary.GetEnumerator() { return new DictionaryEnumerator(this); @@ -1505,11 +1505,11 @@ namespace System.Collections.Concurrent /// /// Gets a value indicating whether the has a fixed size. + /// cref="System.Collections.IDictionary"/> has a fixed size. /// - /// true if the has a + /// true if the has a /// fixed size; otherwise, false. For , this property always + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/>, this property always /// returns false. bool IDictionary.IsFixedSize { @@ -1518,11 +1518,11 @@ namespace System.Collections.Concurrent /// /// Gets a value indicating whether the is read-only. + /// cref="System.Collections.IDictionary"/> is read-only. /// - /// true if the is + /// true if the is /// read-only; otherwise, false. For , this property always + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/>, this property always /// returns false. bool IDictionary.IsReadOnly { @@ -1530,11 +1530,11 @@ namespace System.Collections.Concurrent } /// - /// Gets an containing the keys of the . + /// Gets an containing the keys of the . /// - /// An containing the keys of the . + /// An containing the keys of the . ICollection IDictionary.Keys { get { return GetKeys(); } @@ -1542,10 +1542,10 @@ namespace System.Collections.Concurrent /// /// Removes the element with the specified key from the . + /// cref="System.Collections.IDictionary"/>. /// /// The key of the element to remove. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). void IDictionary.Remove(object key) { @@ -1559,11 +1559,11 @@ namespace System.Collections.Concurrent } /// - /// Gets an containing the values in the . + /// Gets an containing the values in the . /// - /// An containing the values in the . + /// An containing the values in the . ICollection IDictionary.Values { get { return GetValues(); } @@ -1576,16 +1576,16 @@ namespace System.Collections.Concurrent /// The value associated with the specified key, or a null reference (Nothing in Visual Basic) /// if is not in the dictionary or is of a type that is /// not assignable to the key type of the . - /// is a null reference + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/>. + /// is a null reference /// (Nothing in Visual Basic). - /// + /// /// A value is being assigned, and is of a type that is not assignable to the /// key type of the . -or- A value is being + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/>. -or- A value is being /// assigned, and is of a type that is not assignable to the value type /// of the + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/> /// object? IDictionary.this[object key] { @@ -1617,21 +1617,21 @@ namespace System.Collections.Concurrent #region ICollection Members /// - /// Copies the elements of the to an array, starting + /// Copies the elements of the to an array, starting /// at the specified array index. /// /// The one-dimensional array that is the destination of the elements copied from - /// the . The array must have zero-based + /// the . The array must have zero-based /// indexing. /// The zero-based index in at which copying /// begins. - /// is a null reference + /// is a null reference /// (Nothing in Visual Basic). - /// is less than + /// is less than /// 0. - /// is equal to or greater than + /// is equal to or greater than /// the length of the . -or- The number of elements in the source + /// cref="System.Collections.ICollection"/> /// is greater than the available space from to the end of the destination /// . void ICollection.CopyTo(Array array, int index) @@ -1693,12 +1693,12 @@ namespace System.Collections.Concurrent } /// - /// Gets a value indicating whether access to the is + /// Gets a value indicating whether access to the is /// synchronized with the SyncRoot. /// - /// true if access to the is synchronized + /// true if access to the is synchronized /// (thread safe); otherwise, false. For , this property always + /// cref="System.Collections.Concurrent.ConcurrentDictionary{TKey,TValue}"/>, this property always /// returns false. bool ICollection.IsSynchronized { @@ -1707,9 +1707,9 @@ namespace System.Collections.Concurrent /// /// Gets an object that can be used to synchronize access to the . This property is not supported. + /// cref="System.Collections.ICollection"/>. This property is not supported. /// - /// The SyncRoot property is not supported. + /// The SyncRoot property is not supported. object ICollection.SyncRoot { get diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentStack.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentStack.cs index 48f10d5..bf77bb6 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentStack.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/ConcurrentStack.cs @@ -75,7 +75,7 @@ namespace System.Collections.Concurrent /// /// The collection whose elements are copied to the new . - /// The argument is + /// The argument is /// null. public ConcurrentStack(IEnumerable collection) { @@ -160,10 +160,10 @@ namespace System.Collections.Concurrent /// - /// Gets a value indicating whether access to the is + /// Gets a value indicating whether access to the is /// synchronized with the SyncRoot. /// - /// true if access to the is synchronized + /// true if access to the is synchronized /// with the SyncRoot; otherwise, false. For , this property always /// returns false. bool ICollection.IsSynchronized @@ -177,9 +177,9 @@ namespace System.Collections.Concurrent /// /// Gets an object that can be used to synchronize access to the . This property is not supported. + /// cref="System.Collections.ICollection"/>. This property is not supported. /// - /// The SyncRoot property is not supported + /// The SyncRoot property is not supported object ICollection.SyncRoot { get @@ -201,13 +201,13 @@ namespace System.Collections.Concurrent } /// - /// Copies the elements of the to an , starting at a particular - /// index. + /// Copies the elements of the to an , starting at a particular + /// index. /// - /// The one-dimensional that is the destination of + /// The one-dimensional that is the destination of /// the elements copied from the - /// . The must + /// . The must /// have zero-based indexing. /// The zero-based index in at which copying /// begins. @@ -219,10 +219,10 @@ namespace System.Collections.Concurrent /// is multidimensional. -or- /// does not have zero-based indexing. -or- /// is equal to or greater than the length of the - /// -or- The number of elements in the source is + /// -or- The number of elements in the source is /// greater than the available space from to the end of the destination /// . -or- The type of the source cannot be cast automatically to the type of the + /// cref="System.Collections.ICollection"/> cannot be cast automatically to the type of the /// destination . /// void ICollection.CopyTo(Array array, int index) @@ -242,11 +242,11 @@ namespace System.Collections.Concurrent /// /// Copies the elements to an existing one-dimensional , starting at the specified array index. + /// cref="System.Array"/>, starting at the specified array index. /// - /// The one-dimensional that is the destination of + /// The one-dimensional that is the destination of /// the elements copied from the - /// . The must have zero-based + /// . The must have zero-based /// indexing. /// The zero-based index in at which copying /// begins. @@ -423,10 +423,10 @@ namespace System.Collections.Concurrent /// /// Attempts to add an object to the . + /// cref="System.Collections.Concurrent.IProducerConsumerCollection{T}"/>. /// /// The object to add to the . The value can be a null + /// cref="System.Collections.Concurrent.IProducerConsumerCollection{T}"/>. The value can be a null /// reference (Nothing in Visual Basic) for reference types. /// /// true if the object was added successfully; otherwise, false. @@ -444,7 +444,7 @@ namespace System.Collections.Concurrent /// without removing it. /// /// When this method returns, contains an object from - /// the top of the or an + /// the top of the or an /// unspecified value if the operation failed. /// true if and object was returned successfully; otherwise, false. public bool TryPeek([MaybeNullWhen(false)] out T result) @@ -498,7 +498,7 @@ namespace System.Collections.Concurrent /// atomically. /// /// - /// The to which objects popped from the top of the to which objects popped from the top of the will be added. /// /// The number of objects successfully popped from the top of the /// - /// The to which objects popped from the top of the to which objects popped from the top of the will be added. /// /// The zero-based offset in at which to begin @@ -682,7 +682,7 @@ namespace System.Collections.Concurrent /// /// Attempts to remove and return an object from the . + /// cref="System.Collections.Concurrent.IProducerConsumerCollection{T}"/>. /// /// /// When this method returns, if the operation was successful, contains the @@ -773,7 +773,7 @@ namespace System.Collections.Concurrent /// /// Returns an enumerator that iterates through a collection. /// - /// An that can be used to iterate through + /// An that can be used to iterate through /// the collection. /// /// The enumeration represents a moment-in-time snapshot of the contents of the stack. It does not diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/OrderablePartitioner.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/OrderablePartitioner.cs index 7135dcf..3dfc764 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/OrderablePartitioner.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/OrderablePartitioner.cs @@ -33,17 +33,17 @@ namespace System.Collections.Concurrent ///
  • All indices must be non-negative. If any indices are negative, consumers of the implementation /// may throw exceptions.
    • ///
  • and should throw a - /// if the requested partition count is less than or + /// if the requested partition count is less than or /// equal to zero.
    • ///
  • and should always return a number /// of enumerables equal to the requested partition count. If the partitioner runs out of data and cannot /// create as many partitions as requested, an empty enumerator should be returned for each of the /// remaining partitions. If this rule is not followed, consumers of the implementation may throw a .
    • + /// cref="System.InvalidOperationException"/>. ///
  • , , /// , and /// should never return null. If null is returned, a consumer of the implementation may throw a - /// .
    • + /// . ///
  • , , /// , and /// should always return partitions that can fully and uniquely enumerate the input data source. All of @@ -106,7 +106,7 @@ namespace System.Collections.Concurrent /// /// /// The returned object implements the interface. Calling interface. Calling GetEnumerator on the /// object creates another partition over the sequence. /// @@ -187,7 +187,7 @@ namespace System.Collections.Concurrent /// /// /// The returned object implements the interface. Calling interface. Calling GetEnumerator on the /// object creates another partition over the sequence. /// diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/Partitioner.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/Partitioner.cs index 96d30a8..bdb9849 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/Partitioner.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/Partitioner.cs @@ -25,16 +25,16 @@ namespace System.Collections.Concurrent /// Inheritors of must adhere to the following rules: ///
      ///
    1. should throw a - /// if the requested partition count is less than or + /// if the requested partition count is less than or /// equal to zero.
      2. ///
    2. should always return a number of enumerables equal to the requested /// partition count. If the partitioner runs out of data and cannot create as many partitions as /// requested, an empty enumerator should be returned for each of the remaining partitions. If this rule /// is not followed, consumers of the implementation may throw a .
      3. + /// cref="System.InvalidOperationException"/>. ///
    3. and /// should never return null. If null is returned, a consumer of the implementation may throw a - /// .
      4. + /// . ///
    4. and should always return /// partitions that can fully and uniquely enumerate the input data source. All of the data and only the /// data contained in the input source should be enumerated, with no duplication that was not already in @@ -79,7 +79,7 @@ namespace System.Collections.Concurrent /// /// /// The returned object implements the interface. Calling interface. Calling GetEnumerator on the /// object creates another partition over the sequence. /// diff --git a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/PartitionerStatic.cs b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/PartitionerStatic.cs index 6d110d3..b5f83a8 100644 --- a/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/PartitionerStatic.cs +++ b/src/libraries/System.Collections.Concurrent/src/System/Collections/Concurrent/PartitionerStatic.cs @@ -151,9 +151,9 @@ namespace System.Collections.Concurrent /// Type of the elements in source enumerable. /// The enumerable to be partitioned. /// Options to control the buffering behavior of the partitioner. - /// + /// /// The argument specifies an invalid value for . + /// cref="System.Collections.Concurrent.EnumerablePartitionerOptions"/>. /// /// /// An orderable partitioner based on the input array. @@ -179,7 +179,7 @@ namespace System.Collections.Concurrent /// The lower, inclusive bound of the range. /// The upper, exclusive bound of the range. /// A partitioner. - /// The argument is + /// The argument is /// less than or equal to the argument. public static OrderablePartitioner> Create(long fromInclusive, long toExclusive) { @@ -200,9 +200,9 @@ namespace System.Collections.Concurrent /// The upper, exclusive bound of the range. /// The size of each subrange. /// A partitioner. - /// The argument is + /// The argument is /// less than or equal to the argument. - /// The argument is + /// The argument is /// less than or equal to 0. public static OrderablePartitioner> Create(long fromInclusive, long toExclusive, long rangeSize) { @@ -236,7 +236,7 @@ namespace System.Collections.Concurrent /// The lower, inclusive bound of the range. /// The upper, exclusive bound of the range. /// A partitioner. - /// The argument is + /// The argument is /// less than or equal to the argument. public static OrderablePartitioner> Create(int fromInclusive, int toExclusive) { @@ -257,9 +257,9 @@ namespace System.Collections.Concurrent /// The upper, exclusive bound of the range. /// The size of each subrange. /// A partitioner. - /// The argument is + /// The argument is /// less than or equal to the argument. - /// The argument is + /// The argument is /// less than or equal to 0. public static OrderablePartitioner> Create(int fromInclusive, int toExclusive, int rangeSize) { diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableArray_1.Minimal.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableArray_1.Minimal.cs index 04da719..3c0f366 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableArray_1.Minimal.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableArray_1.Minimal.cs @@ -18,7 +18,7 @@ namespace System.Collections.Immutable /// The type of element stored by the array. /// /// This type has a documented contract of being exactly one reference-type field in size. - /// Our own class depends on it, as well as others externally. + /// Our own class depends on it, as well as others externally. /// IMPORTANT NOTICE FOR MAINTAINERS AND REVIEWERS: /// This type should be thread-safe. As a struct, it cannot protect its own fields /// from being changed from one thread while its members are executing on other threads diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableDictionary_2.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableDictionary_2.cs index 932a50c..4432350 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableDictionary_2.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableDictionary_2.cs @@ -1079,7 +1079,7 @@ namespace System.Collections.Immutable /// Bulk adds entries to the map. /// /// The entries to add. - /// true when being called from to avoid . + /// true when being called from to avoid a stack overflow. [Pure] private ImmutableDictionary AddRange(IEnumerable> pairs, bool avoidToHashMap) { diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableExtensions.Minimal.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableExtensions.Minimal.cs index 177b456..e20d413 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableExtensions.Minimal.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableExtensions.Minimal.cs @@ -146,7 +146,7 @@ namespace System.Collections.Immutable /// The number of elements in the sequence. /// The array. /// - /// This is more efficient than the extension method + /// This is more efficient than the extension method /// because that only tries to cast the sequence to to determine /// the count before it falls back to reallocating arrays as it enumerates. /// diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableHashSet_1.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableHashSet_1.cs index 069279f..2668068 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableHashSet_1.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableHashSet_1.cs @@ -1023,7 +1023,7 @@ namespace System.Collections.Immutable /// Bulk adds entries to the set. /// /// The entries to add. - /// true when being called from to avoid . + /// true when being called from to avoid a stack overflow. [Pure] private ImmutableHashSet Union(IEnumerable items, bool avoidWithComparer) { diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableSortedDictionary_2.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableSortedDictionary_2.cs index ce1f976..3c8dff5 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableSortedDictionary_2.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/ImmutableSortedDictionary_2.cs @@ -815,7 +815,7 @@ namespace System.Collections.Immutable /// /// The entries to add. /// true to allow the sequence to include duplicate keys and let the last one win; false to throw on collisions. - /// true when being called from to avoid . + /// true when being called from to avoid a stack overflow. [Pure] private ImmutableSortedDictionary AddRange(IEnumerable> items, bool overwriteOnCollision, bool avoidToSortedMap) { diff --git a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/SortedInt32KeyNode.cs b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/SortedInt32KeyNode.cs index 449d4b8..2d2780d 100644 --- a/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/SortedInt32KeyNode.cs +++ b/src/libraries/System.Collections.Immutable/src/System/Collections/Immutable/SortedInt32KeyNode.cs @@ -17,7 +17,7 @@ namespace System.Collections.Immutable /// with TKey fixed to be . This avoids multiple interface-based dispatches while examining /// each node in the tree during a lookup: an interface call to the comparer's method, /// and then an interface call to 's method as part of - /// the 's implementation. + /// the comparer's implementation. /// [DebuggerDisplay("{_key} = {_value}")] internal sealed partial class SortedInt32KeyNode : IBinaryTree diff --git a/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/CompositionScopeDefinition.cs b/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/CompositionScopeDefinition.cs index 470de40..a2546fd 100644 --- a/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/CompositionScopeDefinition.cs +++ b/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/CompositionScopeDefinition.cs @@ -221,7 +221,7 @@ namespace System.ComponentModel.Composition.Hosting public event EventHandler Changing; /// - /// Raises the event. + /// Raises the event. /// /// The instance containing the event data. protected virtual void OnChanged(ComposablePartCatalogChangeEventArgs e) @@ -234,7 +234,7 @@ namespace System.ComponentModel.Composition.Hosting } /// - /// Raises the event. + /// Raises the event. /// /// The instance containing the event data. protected virtual void OnChanging(ComposablePartCatalogChangeEventArgs e) diff --git a/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/FilteredCatalog.cs b/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/FilteredCatalog.cs index 28b6216..2fdda03 100644 --- a/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/FilteredCatalog.cs +++ b/src/libraries/System.ComponentModel.Composition/src/System/ComponentModel/Composition/Hosting/FilteredCatalog.cs @@ -179,7 +179,7 @@ namespace System.ComponentModel.Composition.Hosting public event EventHandler Changing; /// - /// Raises the event. + /// Raises the event. /// /// The instance containing the event data. protected virtual void OnChanged(ComposablePartCatalogChangeEventArgs e) @@ -192,7 +192,7 @@ namespace System.ComponentModel.Composition.Hosting } /// - /// Raises the event. + /// Raises the event. /// /// The instance containing the event data. protected virtual void OnChanging(ComposablePartCatalogChangeEventArgs e) diff --git a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TypeDescriptor.cs b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TypeDescriptor.cs index 220552b..f8ffcae 100644 --- a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TypeDescriptor.cs +++ b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TypeDescriptor.cs @@ -249,11 +249,6 @@ namespace System.ComponentModel /// components, you would pass typeof(IComponent). Passing typeof(object) /// will cause the provider to be called to provide type information for /// all types. - /// - /// This method can be called from partially trusted code. If - /// - /// is defined, the caller can register a provider for the specified type - /// if it's also partially trusted. /// [EditorBrowsable(EditorBrowsableState.Advanced)] public static void AddProviderTransparent(TypeDescriptionProvider provider, Type type) @@ -277,11 +272,6 @@ namespace System.ComponentModel /// using this method will never have its CreateInstance method called /// because the instance already exists. This method does not prevent /// the object from finalizing. - /// - /// This method can be called from partially trusted code. If - /// - /// is defined, the caller can register a provider for the specified instance - /// if its type is also partially trusted. /// [EditorBrowsable(EditorBrowsableState.Advanced)] public static void AddProviderTransparent(TypeDescriptionProvider provider, object instance) @@ -2501,11 +2491,6 @@ namespace System.ComponentModel /// description provider. Removing a provider causes a Refresh /// event to be raised for the object or type the provider is /// associated with. - /// - /// This method can be called from partially trusted code. If - /// - /// is defined, the caller can unregister a provider for the specified type - /// if it's also partially trusted. /// [EditorBrowsable(EditorBrowsableState.Advanced)] public static void RemoveProviderTransparent(TypeDescriptionProvider provider, Type type) @@ -2528,11 +2513,6 @@ namespace System.ComponentModel /// description provider. Removing a provider causes a Refresh /// event to be raised for the object or type the provider is /// associated with. - /// - /// This method can be called from partially trusted code. If - /// - /// is defined, the caller can register a provider for the specified instance - /// if its type is also partially trusted. /// [EditorBrowsable(EditorBrowsableState.Advanced)] public static void RemoveProviderTransparent(TypeDescriptionProvider provider, object instance) diff --git a/src/libraries/System.Data.Common/src/System/Data/DataSet.cs b/src/libraries/System.Data.Common/src/System/Data/DataSet.cs index 03539a9..81f36b3 100644 --- a/src/libraries/System.Data.Common/src/System/Data/DataSet.cs +++ b/src/libraries/System.Data.Common/src/System/Data/DataSet.cs @@ -1592,7 +1592,7 @@ namespace System.Data } /// - /// Reads the XML schema from the specified into the + /// Reads the XML schema from the specified into the /// public void ReadXmlSchema(XmlReader reader) => ReadXmlSchema(reader, false); diff --git a/src/libraries/System.Data.Common/src/System/Data/DataView.cs b/src/libraries/System.Data.Common/src/System/Data/DataView.cs index cc9ab23..482e232 100644 --- a/src/libraries/System.Data.Common/src/System/Data/DataView.cs +++ b/src/libraries/System.Data.Common/src/System/Data/DataView.cs @@ -1359,7 +1359,7 @@ namespace System.Data } /// - /// Raises the event. + /// Raises the event. /// protected virtual void OnListChanged(ListChangedEventArgs e) { diff --git a/src/libraries/System.Diagnostics.TextWriterTraceListener/src/System/Diagnostics/TextWriterTraceListener.cs b/src/libraries/System.Diagnostics.TextWriterTraceListener/src/System/Diagnostics/TextWriterTraceListener.cs index 817ee85..d2bdc43 100644 --- a/src/libraries/System.Diagnostics.TextWriterTraceListener/src/System/Diagnostics/TextWriterTraceListener.cs +++ b/src/libraries/System.Diagnostics.TextWriterTraceListener/src/System/Diagnostics/TextWriterTraceListener.cs @@ -11,8 +11,8 @@ namespace System.Diagnostics { /// /// Directs tracing or debugging output to - /// a or to a , - /// such as or . + /// a or to a , + /// such as or . /// public class TextWriterTraceListener : TraceListener { diff --git a/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventArgs.cs b/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventArgs.cs index 056e7d5..8f1846a 100644 --- a/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventArgs.cs +++ b/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventArgs.cs @@ -5,7 +5,7 @@ namespace System.IO { /// - /// Provides data for the event. + /// Provides data for the event. /// public class ErrorEventArgs : EventArgs { diff --git a/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventHandler.cs b/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventHandler.cs index fe1644d..3ef0fd7 100644 --- a/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventHandler.cs +++ b/src/libraries/System.IO.FileSystem.Watcher/src/System/IO/ErrorEventHandler.cs @@ -6,8 +6,8 @@ namespace System.IO { /// /// Represents the method that will - /// handle the - /// event of a . + /// handle the + /// event of a . /// public delegate void ErrorEventHandler(object sender, ErrorEventArgs e); } diff --git a/src/libraries/System.Linq.Parallel/src/System/Linq/ParallelEnumerable.cs b/src/libraries/System.Linq.Parallel/src/System/Linq/ParallelEnumerable.cs index b17d4fd..f1d49a2 100644 --- a/src/libraries/System.Linq.Parallel/src/System/Linq/ParallelEnumerable.cs +++ b/src/libraries/System.Linq.Parallel/src/System/Linq/ParallelEnumerable.cs @@ -85,7 +85,7 @@ namespace System.Linq /// to convert to a . /// The source as a to bind to /// ParallelEnumerable extension methods. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery AsParallel(this IEnumerable source) @@ -110,7 +110,7 @@ namespace System.Linq /// whereas the partitioner's GetPartitions is used if ordering is not enabled (the default). /// The source partitioner's GetDynamicPartitions and GetDynamicOrderedPartitions are not used. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery AsParallel(this Partitioner source) @@ -131,10 +131,10 @@ namespace System.Linq /// /// The type of elements of . /// The input sequence. - /// + /// /// Thrown if is not one of AsParallel, ParallelEnumerable.Range, or ParallelEnumerable.Repeat. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// /// @@ -178,7 +178,7 @@ namespace System.Linq /// /// Thrown if the is not one of AsParallel, ParallelEnumerable.Range, or ParallelEnumerable.Repeat. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// /// @@ -213,7 +213,7 @@ namespace System.Linq /// The type of elements of . /// The input sequence. /// The source sequence with arbitrary order. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery AsUnordered(this ParallelQuery source) @@ -235,7 +235,7 @@ namespace System.Linq /// The source as a ParallelQuery to bind to /// ParallelEnumerable extension methods. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery AsParallel(this IEnumerable source) @@ -262,7 +262,7 @@ namespace System.Linq /// A to convert to an . /// The source as an /// to bind to sequential extension methods. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static IEnumerable AsSequential(this ParallelQuery source) @@ -289,13 +289,13 @@ namespace System.Linq /// A ParallelQuery on which to set the limit on the degrees of parallelism. /// The degree of parallelism for the query. /// ParallelQuery representing the same query as source, with the limit on the degrees of parallelism set. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// WithDegreeOfParallelism is used multiple times in the query. /// - /// + /// /// is less than 1 or greater than 512. /// public static ParallelQuery WithDegreeOfParallelism(this ParallelQuery source, int degreeOfParallelism) @@ -321,10 +321,10 @@ namespace System.Linq /// A cancellation token. /// ParallelQuery representing the same query as source, but with the /// registered. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// WithCancellation is used multiple times in the query. /// public static ParallelQuery WithCancellation(this ParallelQuery source, CancellationToken cancellationToken) @@ -346,13 +346,13 @@ namespace System.Linq /// The mode in which to execute the query. /// ParallelQuery representing the same query as source, but with the /// registered. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// is not a valid value. + /// + /// is not a valid value. /// - /// + /// /// WithExecutionMode is used multiple times in the query. /// public static ParallelQuery WithExecutionMode(this ParallelQuery source, ParallelExecutionMode executionMode) @@ -378,13 +378,13 @@ namespace System.Linq /// The merge options to set for this query. /// ParallelQuery representing the same query as source, but with the /// registered. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// is not a valid value. + /// + /// is not a valid value. /// - /// + /// /// WithMergeOptions is used multiple times in the query. /// public static ParallelQuery WithMergeOptions(this ParallelQuery source, ParallelMergeOptions mergeOptions) @@ -416,10 +416,10 @@ namespace System.Linq /// The number of sequential integers to generate. /// An IEnumerable<Int32> in C# or IEnumerable(Of Int32) in /// Visual Basic that contains a range of sequential integral numbers. - /// + /// /// is less than 0 /// -or- - /// + - 1 is larger than . + /// + - 1 is larger than . /// public static ParallelQuery Range(int start, int count) { @@ -438,7 +438,7 @@ namespace System.Linq /// The value to be repeated. /// The number of times to repeat the value in the generated sequence. /// A sequence that contains a repeated value. - /// + /// /// is less than 0. /// public static ParallelQuery Repeat(TResult element, int count) @@ -490,13 +490,13 @@ namespace System.Linq /// The whose elements will be processed by /// . /// An Action to invoke on each element. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static void ForAll(this ParallelQuery source, Action action) @@ -528,7 +528,7 @@ namespace System.Linq /// A function to test each element for a condition. /// A sequence that contains elements from the input sequence that satisfy /// the condition. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Where(this ParallelQuery source, Func predicate) @@ -546,7 +546,7 @@ namespace System.Linq /// A sequence to filter. /// A function to test each element for a condition. /// A sequence that contains elements from the input sequence that satisfy the condition. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Where(this ParallelQuery source, Func predicate) @@ -571,7 +571,7 @@ namespace System.Linq /// A transform function to apply to each element. /// A sequence whose elements are the result of invoking the transform function on each /// element of . - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Select( @@ -592,7 +592,7 @@ namespace System.Linq /// A transform function to apply to each element. /// A sequence whose elements are the result of invoking the transform function on each /// element of . - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Select( @@ -622,7 +622,7 @@ namespace System.Linq /// resultSelector pairwise on two sequences. If the sequence lengths are unequal, this truncates /// to the length of the shorter sequence. /// - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Zip( @@ -647,7 +647,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Zip with a left data source of type /// and a right data source of type . @@ -682,7 +682,7 @@ namespace System.Linq /// A function to create a result element from two matching elements. /// A sequence that has elements of type that are obtained by performing /// an inner join on two sequences. - /// + /// /// or or or /// or is a null reference (Nothing in Visual Basic). /// @@ -709,7 +709,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage Join with a left data source of type /// and a right data source of type . @@ -742,7 +742,7 @@ namespace System.Linq /// An IEqualityComparer<(Of <(T>)>) to hash and compare keys. /// A sequence that has elements of type that are obtained by performing /// an inner join on two sequences. - /// + /// /// or or or /// or is a null reference (Nothing in Visual Basic). /// @@ -776,7 +776,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Join with a left data source of type /// and a right data source of type . @@ -814,7 +814,7 @@ namespace System.Linq /// the first sequence and a collection of matching elements from the second sequence. /// A sequence that has elements of type that are obtained by performing /// a grouped join on two sequences. - /// + /// /// or or or /// or is a null reference (Nothing in Visual Basic). /// @@ -841,7 +841,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of GroupJoin with a left data source of type /// and a right data source of type . @@ -876,7 +876,7 @@ namespace System.Linq /// An IEqualityComparer<(Of <(T>)>) to hash and compare keys. /// A sequence that has elements of type that are obtained by performing /// a grouped join on two sequences. - /// + /// /// or or or /// or is a null reference (Nothing in Visual Basic). /// @@ -910,7 +910,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of GroupJoin with a left data source of type /// and a right data source of type . @@ -942,7 +942,7 @@ namespace System.Linq /// A transform function to apply to each element. /// A sequence whose elements are the result of invoking the one-to-many transform /// function on each element of the input sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery SelectMany( @@ -965,7 +965,7 @@ namespace System.Linq /// A transform function to apply to each element. /// A sequence whose elements are the result of invoking the one-to-many transform /// function on each element of the input sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery SelectMany( @@ -993,7 +993,7 @@ namespace System.Linq /// A sequence whose elements are the result of invoking the one-to-many transform /// function on each element of and then mapping /// each of those sequence elements and their corresponding source element to a result element. - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1029,7 +1029,7 @@ namespace System.Linq /// each of those sequence elements and their corresponding source element to a /// result element. /// - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1065,7 +1065,7 @@ namespace System.Linq /// A function to extract a key from an element. /// An OrderedParallelQuery{TSource} whose elements are sorted /// according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static OrderedParallelQuery OrderBy( @@ -1093,7 +1093,7 @@ namespace System.Linq /// An IComparer{TKey} to compare keys. /// An OrderedParallelQuery{TSource} whose elements are sorted according /// to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static OrderedParallelQuery OrderBy( @@ -1120,7 +1120,7 @@ namespace System.Linq /// A function to extract a key from an element. /// An OrderedParallelQuery{TSource} whose elements are sorted /// descending according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static OrderedParallelQuery OrderByDescending( @@ -1147,7 +1147,7 @@ namespace System.Linq /// An IComparer{TKey} to compare keys. /// An OrderedParallelQuery{TSource} whose elements are sorted descending /// according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static OrderedParallelQuery OrderByDescending( @@ -1176,7 +1176,7 @@ namespace System.Linq /// A function to extract a key from an element. /// An OrderedParallelQuery{TSource} whose elements are /// sorted according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// @@ -1206,7 +1206,7 @@ namespace System.Linq /// An IComparer{TKey} to compare keys. /// An OrderedParallelQuery{TSource} whose elements are sorted /// according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// /// @@ -1236,7 +1236,7 @@ namespace System.Linq /// A function to extract a key from an element. /// An OrderedParallelQuery{TSource} whose elements are sorted /// descending according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// /// @@ -1267,7 +1267,7 @@ namespace System.Linq /// An IComparer{TKey} to compare keys. /// An OrderedParallelQuery{TSource} whose elements are sorted /// descending according to a key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// /// @@ -1295,7 +1295,7 @@ namespace System.Linq /// A function to extract a key from an element. /// A collection of elements of type IGrouping{TKey, TElement}, where each element represents a /// group and its key. - /// + /// /// or /// is a null reference (Nothing in Visual Basic). /// @@ -1315,7 +1315,7 @@ namespace System.Linq /// An equality comparer to compare keys. /// A collection of elements of type IGrouping{TKey, TElement}, where each element represents a /// group and its key. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery> GroupBy( @@ -1341,7 +1341,7 @@ namespace System.Linq /// IGrouping{Key, TElement}. /// A collection of elements of type IGrouping{TKey, TElement}, where each element represents a /// group and its key. - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1367,7 +1367,7 @@ namespace System.Linq /// An equality comparer to compare keys. /// A collection of elements of type IGrouping{TKey, TElement}, where each element represents a /// group and its key. - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1406,7 +1406,7 @@ namespace System.Linq /// A function to create a result value from each group. /// A collection of elements of type where each element represents a /// projection over a group and its key. - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1434,7 +1434,7 @@ namespace System.Linq /// An equality comparer to compare keys. /// A collection of elements of type where each element represents a /// projection over a group and its key. - /// + /// /// or or /// is a null reference (Nothing in Visual Basic). /// @@ -1464,7 +1464,7 @@ namespace System.Linq /// A function to create a result value from each group. /// A collection of elements of type where each element represents a /// projection over a group and its key. - /// + /// /// or or /// or is a null reference (Nothing in Visual Basic). /// @@ -1495,7 +1495,7 @@ namespace System.Linq /// An equality comparer to compare keys. /// A collection of elements of type where each element represents a /// projection over a group and its key. - /// + /// /// or or /// or is a null reference (Nothing in Visual Basic). /// @@ -1611,16 +1611,16 @@ namespace System.Linq /// A sequence to aggregate over. /// An accumulator function to be invoked on each element. /// The final accumulator value. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Aggregate( @@ -1661,13 +1661,13 @@ namespace System.Linq /// The initial accumulator value. /// An accumulator function to be invoked on each element. /// The final accumulator value. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TAccumulate Aggregate( @@ -1700,13 +1700,13 @@ namespace System.Linq /// A function to transform the final accumulator value /// into the result value. /// The transformed final accumulator value. - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TResult Aggregate( @@ -1762,14 +1762,14 @@ namespace System.Linq /// A function to transform the final accumulator value into the result value. /// /// The transformed final accumulator value. - /// + /// /// or /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TResult Aggregate( @@ -1815,14 +1815,14 @@ namespace System.Linq /// A function to transform the final accumulator value into the result value. /// /// The transformed final accumulator value. - /// + /// /// or or /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TResult Aggregate( @@ -1854,15 +1854,15 @@ namespace System.Linq /// The type of the elements of . /// A sequence that contains elements to be counted. /// The number of elements in the input sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The number of elements in source is larger than . + /// + /// The number of elements in source is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Count(this ParallelQuery source) @@ -1898,15 +1898,15 @@ namespace System.Linq /// A number that represents how many elements in the sequence satisfy the condition /// in the predicate function. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The number of elements in source is larger than . + /// + /// The number of elements in source is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Count(this ParallelQuery source, Func predicate) @@ -1927,15 +1927,15 @@ namespace System.Linq /// The type of the elements of . /// A sequence that contains elements to be counted. /// The number of elements in the input sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The number of elements in source is larger than . + /// + /// The number of elements in source is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long LongCount(this ParallelQuery source) @@ -1967,15 +1967,15 @@ namespace System.Linq /// A number that represents how many elements in the sequence satisfy the condition /// in the predicate function. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The number of elements in source is larger than . + /// + /// The number of elements in source is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long LongCount(this ParallelQuery source, Func predicate) @@ -1996,15 +1996,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Sum(this ParallelQuery source) @@ -2018,15 +2018,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Sum(this ParallelQuery source) @@ -2040,15 +2040,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Sum(this ParallelQuery source) @@ -2062,15 +2062,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Sum(this ParallelQuery source) @@ -2084,13 +2084,13 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Sum(this ParallelQuery source) @@ -2104,13 +2104,13 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Sum(this ParallelQuery source) @@ -2124,13 +2124,13 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Sum(this ParallelQuery source) @@ -2144,13 +2144,13 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Sum(this ParallelQuery source) @@ -2164,15 +2164,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Sum(this ParallelQuery source) @@ -2186,15 +2186,15 @@ namespace System.Linq /// /// A sequence of values to calculate the sum of. /// The sum of the values in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Sum(this ParallelQuery source) @@ -2210,15 +2210,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Sum(this ParallelQuery source, Func selector) @@ -2234,15 +2234,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Sum(this ParallelQuery source, Func selector) @@ -2258,15 +2258,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Sum(this ParallelQuery source, Func selector) @@ -2282,15 +2282,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Sum(this ParallelQuery source, Func selector) @@ -2306,13 +2306,13 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Sum(this ParallelQuery source, Func selector) @@ -2328,13 +2328,13 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Sum(this ParallelQuery source, Func selector) @@ -2350,13 +2350,13 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Sum(this ParallelQuery source, Func selector) @@ -2372,13 +2372,13 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Sum(this ParallelQuery source, Func selector) @@ -2394,15 +2394,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Sum(this ParallelQuery source, Func selector) @@ -2418,15 +2418,15 @@ namespace System.Linq /// A sequence of values to calculate the sum of. /// A transform function to apply to each element. /// The sum of the values in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum is larger than . + /// + /// The sum is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Sum(this ParallelQuery source, Func selector) @@ -2453,16 +2453,16 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Min(this ParallelQuery source) @@ -2476,13 +2476,13 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Min(this ParallelQuery source) @@ -2496,16 +2496,16 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Min(this ParallelQuery source) @@ -2519,13 +2519,13 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Min(this ParallelQuery source) @@ -2539,16 +2539,16 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Min(this ParallelQuery source) @@ -2562,13 +2562,13 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Min(this ParallelQuery source) @@ -2582,16 +2582,16 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Min(this ParallelQuery source) @@ -2605,13 +2605,13 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Min(this ParallelQuery source) @@ -2625,16 +2625,16 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Min(this ParallelQuery source) @@ -2648,13 +2648,13 @@ namespace System.Linq /// /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Min(this ParallelQuery source) @@ -2669,16 +2669,16 @@ namespace System.Linq /// The type of elements of . /// A sequence of values to determine the minimum value of. /// The minimum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements and is a non-nullable value type. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Min(this ParallelQuery source) @@ -2695,16 +2695,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Min(this ParallelQuery source, Func selector) @@ -2720,13 +2720,13 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Min(this ParallelQuery source, Func selector) @@ -2742,16 +2742,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Min(this ParallelQuery source, Func selector) @@ -2767,13 +2767,13 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Min(this ParallelQuery source, Func selector) @@ -2789,16 +2789,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Min(this ParallelQuery source, Func selector) @@ -2814,13 +2814,13 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Min(this ParallelQuery source, Func selector) @@ -2836,16 +2836,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Min(this ParallelQuery source, Func selector) @@ -2861,13 +2861,13 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Min(this ParallelQuery source, Func selector) @@ -2883,16 +2883,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Min(this ParallelQuery source, Func selector) @@ -2908,13 +2908,13 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Min(this ParallelQuery source, Func selector) @@ -2931,16 +2931,16 @@ namespace System.Linq /// A sequence of values to determine the minimum value of. /// A transform function to apply to each element. /// The minimum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements and is a non-nullable value type. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TResult Min(this ParallelQuery source, Func selector) @@ -2957,16 +2957,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Max(this ParallelQuery source) @@ -2980,13 +2980,13 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Max(this ParallelQuery source) @@ -3000,16 +3000,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Max(this ParallelQuery source) @@ -3023,13 +3023,13 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Max(this ParallelQuery source) @@ -3043,16 +3043,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Max(this ParallelQuery source) @@ -3066,13 +3066,13 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Max(this ParallelQuery source) @@ -3086,16 +3086,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Max(this ParallelQuery source) @@ -3109,13 +3109,13 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Max(this ParallelQuery source) @@ -3129,16 +3129,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Max(this ParallelQuery source) @@ -3152,13 +3152,13 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Max(this ParallelQuery source) @@ -3172,16 +3172,16 @@ namespace System.Linq /// /// A sequence of values to determine the maximum value of. /// The maximum value in the sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements and is a non-nullable value type. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Max(this ParallelQuery source) @@ -3198,16 +3198,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int Max(this ParallelQuery source, Func selector) @@ -3223,13 +3223,13 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static int? Max(this ParallelQuery source, Func selector) @@ -3245,16 +3245,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long Max(this ParallelQuery source, Func selector) @@ -3270,13 +3270,13 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static long? Max(this ParallelQuery source, Func selector) @@ -3292,16 +3292,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Max(this ParallelQuery source, Func selector) @@ -3317,13 +3317,13 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Max(this ParallelQuery source, Func selector) @@ -3339,16 +3339,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Max(this ParallelQuery source, Func selector) @@ -3364,13 +3364,13 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Max(this ParallelQuery source, Func selector) @@ -3386,16 +3386,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Max(this ParallelQuery source, Func selector) @@ -3411,13 +3411,13 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Max(this ParallelQuery source, Func selector) @@ -3434,16 +3434,16 @@ namespace System.Linq /// A sequence of values to determine the maximum value of. /// A transform function to apply to each element. /// The maximum value in the sequence. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements and is a non-nullable value type. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TResult Max(this ParallelQuery source, Func selector) @@ -3460,18 +3460,18 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source) @@ -3485,15 +3485,15 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source) @@ -3507,18 +3507,18 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source) @@ -3532,15 +3532,15 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source) @@ -3554,16 +3554,16 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Average(this ParallelQuery source) @@ -3577,13 +3577,13 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Average(this ParallelQuery source) @@ -3597,16 +3597,16 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source) @@ -3618,15 +3618,15 @@ namespace System.Linq /// /// Computes in parallel the average of a sequence of values. /// - /// + /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source) @@ -3640,16 +3640,16 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Average(this ParallelQuery source) @@ -3663,13 +3663,13 @@ namespace System.Linq /// /// A sequence of values that are used to calculate an average. /// The average of the sequence of values. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Average(this ParallelQuery source) @@ -3686,18 +3686,18 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source, Func selector) @@ -3713,15 +3713,15 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source, Func selector) @@ -3737,18 +3737,18 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source, Func selector) @@ -3764,15 +3764,15 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// - /// The sum or count of the elements in the sequence is larger than . + /// + /// The sum or count of the elements in the sequence is larger than . /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source, Func selector) @@ -3788,16 +3788,16 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float Average(this ParallelQuery source, Func selector) @@ -3813,13 +3813,13 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static float? Average(this ParallelQuery source, Func selector) @@ -3835,16 +3835,16 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double Average(this ParallelQuery source, Func selector) @@ -3860,13 +3860,13 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static double? Average(this ParallelQuery source, Func selector) @@ -3882,16 +3882,16 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal Average(this ParallelQuery source, Func selector) @@ -3907,13 +3907,13 @@ namespace System.Linq /// A sequence of values that are used to calculate an average. /// A transform function to apply to each element. /// The average of the sequence of values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static decimal? Average(this ParallelQuery source, Func selector) @@ -3934,13 +3934,13 @@ namespace System.Linq /// /// true if any elements in the source sequence pass the test in the specified predicate; otherwise, false. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool Any(this ParallelQuery source, Func predicate) @@ -3957,13 +3957,13 @@ namespace System.Linq /// The type of elements of . /// The IEnumerable to check for emptiness. /// true if the source sequence contains any elements; otherwise, false. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool Any(this ParallelQuery source) @@ -3986,13 +3986,13 @@ namespace System.Linq /// /// true if all elements in the source sequence pass the test in the specified predicate; otherwise, false. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool All(this ParallelQuery source, Func predicate) @@ -4017,13 +4017,13 @@ namespace System.Linq /// /// true if the source sequence contains an element that has the specified value; otherwise, false. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool Contains(this ParallelQuery source, TSource value) @@ -4042,13 +4042,13 @@ namespace System.Linq /// /// true if the source sequence contains an element that has the specified value; otherwise, false. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool Contains(this ParallelQuery source, TSource value, IEqualityComparer comparer) @@ -4077,7 +4077,7 @@ namespace System.Linq /// /// A sequence that contains the specified number of elements from the start of the input sequence. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Take(this ParallelQuery source, int count) @@ -4109,7 +4109,7 @@ namespace System.Linq /// A sequence that contains the elements from the input sequence that occur before /// the element at which the test no longer passes. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery TakeWhile(this ParallelQuery source, Func predicate) @@ -4134,7 +4134,7 @@ namespace System.Linq /// A sequence that contains elements from the input sequence that occur before /// the element at which the test no longer passes. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery TakeWhile(this ParallelQuery source, Func predicate) @@ -4159,7 +4159,7 @@ namespace System.Linq /// /// A sequence that contains the elements that occur after the specified index in the input sequence. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Skip(this ParallelQuery source, int count) @@ -4191,7 +4191,7 @@ namespace System.Linq /// A sequence that contains the elements from the input sequence starting at /// the first element in the linear series that does not pass the test specified by /// predicate. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery SkipWhile(this ParallelQuery source, Func predicate) @@ -4218,7 +4218,7 @@ namespace System.Linq /// first element in the linear series that does not pass the test specified by /// predicate. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery SkipWhile(this ParallelQuery source, Func predicate) @@ -4244,7 +4244,7 @@ namespace System.Linq /// The first sequence to concatenate. /// The sequence to concatenate to the first sequence. /// A sequence that contains the concatenated elements of the two input sequences. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Concat(this ParallelQuery first, ParallelQuery second) @@ -4262,7 +4262,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Concat with a left data source of type /// and a right data source of type . @@ -4290,13 +4290,13 @@ namespace System.Linq /// true if the two source sequences are of equal length and their corresponding elements /// are equal according to the default equality comparer for their type; otherwise, false. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool SequenceEqual(this ParallelQuery first, ParallelQuery second) @@ -4314,7 +4314,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// Thrown every time this method is called. + /// Thrown every time this method is called. /// /// This overload exists to disallow usage of SequenceEqual with a left data source of type /// and a right data source of type . @@ -4339,13 +4339,13 @@ namespace System.Linq /// true if the two source sequences are of equal length and their corresponding /// elements are equal according to the default equality comparer for their type; otherwise, false. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static bool SequenceEqual(this ParallelQuery first, ParallelQuery second, IEqualityComparer comparer) @@ -4435,7 +4435,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// Thrown every time this method is called. + /// Thrown every time this method is called. /// /// This overload exists to disallow usage of SequenceEqual with a left data source of type /// and a right data source of type . @@ -4459,7 +4459,7 @@ namespace System.Linq /// The type of the elements of . /// The sequence to remove duplicate elements from. /// A sequence that contains distinct elements from the source sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Distinct( @@ -4476,7 +4476,7 @@ namespace System.Linq /// The sequence to remove duplicate elements from. /// An IEqualityComparer<(Of <(T>)>) to compare values. /// A sequence that contains distinct elements from the source sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Distinct( @@ -4498,7 +4498,7 @@ namespace System.Linq /// A sequence whose distinct elements form the first set for the union. /// A sequence whose distinct elements form the second set for the union. /// A sequence that contains the elements from both input sequences, excluding duplicates. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Union( @@ -4515,7 +4515,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Union with a left data source of type /// and a right data source of type . @@ -4537,7 +4537,7 @@ namespace System.Linq /// A sequence whose distinct elements form the second set for the union. /// An IEqualityComparer<(Of <(T>)>) to compare values. /// A sequence that contains the elements from both input sequences, excluding duplicates. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Union( @@ -4558,7 +4558,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Union with a left data source of type /// and a right data source of type . @@ -4588,7 +4588,7 @@ namespace System.Linq /// A sequence whose distinct elements that also appear in the first sequence will be returned. /// /// A sequence that contains the elements that form the set intersection of two sequences. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Intersect( @@ -4605,7 +4605,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Intersect with a left data source of type /// and a right data source of type . @@ -4632,7 +4632,7 @@ namespace System.Linq /// /// An IEqualityComparer<(Of <(T>)>) to compare values. /// A sequence that contains the elements that form the set intersection of two sequences. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Intersect( @@ -4653,7 +4653,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Intersect with a left data source of type /// and a right data source of type . @@ -4685,7 +4685,7 @@ namespace System.Linq /// elements to be removed from the returned sequence. /// /// A sequence that contains the set difference of the elements of two sequences. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Except( @@ -4702,7 +4702,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Except with a left data source of type /// and a right data source of type . @@ -4728,7 +4728,7 @@ namespace System.Linq /// /// An IEqualityComparer<(Of <(T>)>) to compare values. /// A sequence that contains the set difference of the elements of two sequences. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Except( @@ -4749,7 +4749,7 @@ namespace System.Linq /// This parameter is not used. /// This parameter is not used. /// This overload always throws a . - /// The exception that occurs when this method is called. + /// The exception that occurs when this method is called. /// /// This overload exists to disallow usage of Except with a left data source of type /// and a right data source of type . @@ -4779,7 +4779,7 @@ namespace System.Linq /// The type of the elements of . /// The sequence to type as . /// The input sequence types as . - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static IEnumerable AsEnumerable(this ParallelQuery source) @@ -4798,13 +4798,13 @@ namespace System.Linq /// The type of the elements of . /// A sequence to create an array from. /// An array that contains the elements from the input sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource[] ToArray(this ParallelQuery source) @@ -4832,13 +4832,13 @@ namespace System.Linq /// The type of the elements of . /// A sequence to create a List<(Of <(T>)>) from. /// A List<(Of <(T>)>) that contains elements from the input sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static List ToList(this ParallelQuery source) @@ -4910,17 +4910,17 @@ namespace System.Linq /// A sequence to create a Dictionary<(Of <(TKey, TValue>)>) from. /// A function to extract a key from each element. /// A Dictionary<(Of <(TKey, TValue>)>) that contains keys and values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// produces a key that is a null reference (Nothing in Visual Basic). /// -or- /// produces duplicate keys for two elements. /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static Dictionary ToDictionary( @@ -4939,17 +4939,17 @@ namespace System.Linq /// A function to extract a key from each element. /// An IEqualityComparer<(Of <(T>)>) to compare keys. /// A Dictionary<(Of <(TKey, TValue>)>) that contains keys and values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// produces a key that is a null reference (Nothing in Visual Basic). /// -or- /// produces duplicate keys for two elements. /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static Dictionary ToDictionary( @@ -5008,17 +5008,17 @@ namespace System.Linq /// A Dictionary<(Of <(TKey, TValue>)>) that contains values of type /// selected from the input sequence /// - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// produces a key that is a null reference (Nothing in Visual Basic). /// -or- /// produces duplicate keys for two elements. /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static Dictionary ToDictionary( @@ -5043,17 +5043,17 @@ namespace System.Linq /// A Dictionary<(Of <(TKey, TValue>)>) that contains values of type /// selected from the input sequence /// - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// produces a key that is a null reference (Nothing in Visual Basic). /// -or- /// produces duplicate keys for two elements. /// -or- /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static Dictionary ToDictionary( @@ -5111,13 +5111,13 @@ namespace System.Linq /// The sequence to create a Lookup<(Of <(TKey, TElement>)>) from. /// A function to extract a key from each element. /// A Lookup<(Of <(TKey, TElement>)>) that contains keys and values. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static ILookup ToLookup( @@ -5136,13 +5136,13 @@ namespace System.Linq /// A function to extract a key from each element. /// An IEqualityComparer<(Of <(T>)>) to compare keys. /// A Lookup<(Of <(TKey, TElement>)>) that contains keys and values. - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static ILookup ToLookup( @@ -5190,13 +5190,13 @@ namespace System.Linq /// A Lookup<(Of <(TKey, TElement>)>) that contains values of type TElement /// selected from the input sequence. /// - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static ILookup ToLookup( @@ -5222,13 +5222,13 @@ namespace System.Linq /// A Lookup<(Of <(TKey, TElement>)>) that contains values of type TElement selected /// from the input sequence. /// - /// + /// /// or or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static ILookup ToLookup( @@ -5275,7 +5275,7 @@ namespace System.Linq /// The type of the elements of . /// A sequence of values to reverse. /// A sequence whose elements correspond to those of the input sequence in reverse order. - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Reverse(this ParallelQuery source) @@ -5296,7 +5296,7 @@ namespace System.Linq /// The type to filter the elements of the sequence on. /// The sequence whose elements to filter. /// A sequence that contains elements from the input sequence of type . - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery OfType(this ParallelQuery source) @@ -5314,7 +5314,7 @@ namespace System.Linq /// /// A sequence that contains each weakly-type element of the source sequence converted to the specified stronger type. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery Cast(this ParallelQuery source) @@ -5391,16 +5391,16 @@ namespace System.Linq /// The type of the elements of . /// The sequence to return the first element of. /// The first element in the specified sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource First(this ParallelQuery source) @@ -5434,16 +5434,16 @@ namespace System.Linq /// The sequence to return an element from. /// A function to test each element for a condition. /// The first element in the sequence that passes the test in the specified predicate function. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// No element in satisfies the condition in . /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource First(this ParallelQuery source, Func predicate) @@ -5476,13 +5476,13 @@ namespace System.Linq /// /// default(TSource) if is empty; otherwise, the first element in . /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource FirstOrDefault(this ParallelQuery source) @@ -5522,13 +5522,13 @@ namespace System.Linq /// specified by predicate; otherwise, the first element in that /// passes the test specified by predicate. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource FirstOrDefault(this ParallelQuery source, Func predicate) @@ -5567,16 +5567,16 @@ namespace System.Linq /// The type of the elements of . /// The sequence to return the last element from. /// The value at the last position in the source sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// contains no elements. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Last(this ParallelQuery source) @@ -5610,16 +5610,16 @@ namespace System.Linq /// /// The last element in the sequence that passes the test in the specified predicate function. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// No element in satisfies the condition in . /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Last(this ParallelQuery source, Func predicate) @@ -5654,13 +5654,13 @@ namespace System.Linq /// /// default() if the source sequence is empty; otherwise, the last element in the sequence. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource LastOrDefault(this ParallelQuery source) @@ -5696,13 +5696,13 @@ namespace System.Linq /// default() if the sequence is empty or if no elements pass the test in the /// predicate function; otherwise, the last element that passes the test in the predicate function. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource LastOrDefault(this ParallelQuery source, Func predicate) @@ -5741,16 +5741,16 @@ namespace System.Linq /// The type of the elements of . /// The sequence to return the single element of. /// The single element of the input sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// The input sequence contains more than one element. -or- The input sequence is empty. /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Single(this ParallelQuery source) @@ -5770,16 +5770,16 @@ namespace System.Linq /// The sequence to return the single element of. /// A function to test an element for a condition. /// The single element of the input sequence that satisfies a condition. - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// No element satisfies the condition in . -or- More than one element satisfies the condition in . /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource Single(this ParallelQuery source, Func predicate) @@ -5800,13 +5800,13 @@ namespace System.Linq /// The single element of the input sequence, or default() if the /// sequence contains no elements. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource SingleOrDefault(this ParallelQuery source) @@ -5830,13 +5830,13 @@ namespace System.Linq /// The single element of the input sequence that satisfies the condition, or /// default() if no such element is found. /// - /// + /// /// or is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource SingleOrDefault(this ParallelQuery source, Func predicate) @@ -5861,7 +5861,7 @@ namespace System.Linq /// /// A sequence that contains default(TSource) if is empty; otherwise, . /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery DefaultIfEmpty(this ParallelQuery source) @@ -5879,7 +5879,7 @@ namespace System.Linq /// /// A sequence that contains defaultValue if is empty; otherwise, . /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// public static ParallelQuery DefaultIfEmpty(this ParallelQuery source, TSource defaultValue) @@ -5901,16 +5901,16 @@ namespace System.Linq /// A sequence to return an element from. /// The zero-based index of the element to retrieve. /// The element at the specified position in the source sequence. - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// is less than 0 or greater than or equal to the number of elements in . /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource ElementAt(this ParallelQuery source, int index) @@ -5943,13 +5943,13 @@ namespace System.Linq /// default(TSource) if the index is outside the bounds of the source sequence; /// otherwise, the element at the specified position in the source sequence. /// - /// + /// /// is a null reference (Nothing in Visual Basic). /// - /// + /// /// One or more exceptions occurred during the evaluation of the query. /// - /// + /// /// The query was canceled. /// public static TSource ElementAtOrDefault(this ParallelQuery source, int index) diff --git a/src/libraries/System.Linq/src/System/Linq/Concat.cs b/src/libraries/System.Linq/src/System/Linq/Concat.cs index 6c0aaaa..a269ce0 100644 --- a/src/libraries/System.Linq/src/System/Linq/Concat.cs +++ b/src/libraries/System.Linq/src/System/Linq/Concat.cs @@ -113,8 +113,8 @@ namespace System.Linq /// otherwise, false. /// /// - /// This flag allows us to determine in O(1) time whether we can preallocate for - /// and , and whether we can get the count of the iterator cheaply. + /// This flag allows us to determine in O(1) time whether we can preallocate for ToArray/ToList, + /// and whether we can get the count of the iterator cheaply. /// private readonly bool _hasOnlyCollections; diff --git a/src/libraries/System.Linq/src/System/Linq/Select.cs b/src/libraries/System.Linq/src/System/Linq/Select.cs index 2cccaf0..0f96ab4 100644 --- a/src/libraries/System.Linq/src/System/Linq/Select.cs +++ b/src/libraries/System.Linq/src/System/Linq/Select.cs @@ -150,7 +150,7 @@ namespace System.Linq } /// - /// An iterator that maps each item of a . + /// An iterator that maps each item of a array. /// /// The type of the source array. /// The type of the mapped items. diff --git a/src/libraries/System.Linq/src/System/Linq/SingleLinkedNode.cs b/src/libraries/System.Linq/src/System/Linq/SingleLinkedNode.cs index fdcb433..1d59949 100644 --- a/src/libraries/System.Linq/src/System/Linq/SingleLinkedNode.cs +++ b/src/libraries/System.Linq/src/System/Linq/SingleLinkedNode.cs @@ -86,7 +86,7 @@ namespace System.Linq } /// - /// Returns an that contains the items of this node's singly-linked list in reverse. + /// Returns an array that contains the items of this node's singly-linked list in reverse. /// /// The number of items in this node. public TSource[] ToArray(int count) diff --git a/src/libraries/System.Linq/src/System/Linq/Where.cs b/src/libraries/System.Linq/src/System/Linq/Where.cs index 80c8a01..dcdf6b1 100644 --- a/src/libraries/System.Linq/src/System/Linq/Where.cs +++ b/src/libraries/System.Linq/src/System/Linq/Where.cs @@ -139,7 +139,7 @@ namespace System.Linq } /// - /// An iterator that filters each item of a . + /// An iterator that filters each item of an array. /// /// The type of the source array. internal sealed partial class WhereArrayIterator : Iterator @@ -240,7 +240,7 @@ namespace System.Linq } /// - /// An iterator that filters, then maps, each item of a . + /// An iterator that filters, then maps, each item of an array. /// /// The type of the source array. /// The type of the mapped items. diff --git a/src/libraries/System.Management/src/System/Management/ManagementEventWatcher.cs b/src/libraries/System.Management/src/System/Management/ManagementEventWatcher.cs index 7b278b5..f516b8d 100644 --- a/src/libraries/System.Management/src/System/Management/ManagementEventWatcher.cs +++ b/src/libraries/System.Management/src/System/Management/ManagementEventWatcher.cs @@ -9,12 +9,12 @@ using System.Threading; namespace System.Management { /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void EventArrivedEventHandler(object sender, EventArrivedEventArgs e); /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void StoppedEventHandler (object sender, StoppedEventArgs e); diff --git a/src/libraries/System.Management/src/System/Management/ManagementOperationWatcher.cs b/src/libraries/System.Management/src/System/Management/ManagementOperationWatcher.cs index 5f3547f..8548b7c 100644 --- a/src/libraries/System.Management/src/System/Management/ManagementOperationWatcher.cs +++ b/src/libraries/System.Management/src/System/Management/ManagementOperationWatcher.cs @@ -9,22 +9,22 @@ namespace System.Management { /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void ObjectReadyEventHandler(object sender, ObjectReadyEventArgs e); /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void CompletedEventHandler (object sender, CompletedEventArgs e); /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void ProgressEventHandler (object sender, ProgressEventArgs e); /// - /// Represents the method that will handle the event. + /// Represents the method that will handle the event. /// public delegate void ObjectPutEventHandler(object sender, ObjectPutEventArgs e); diff --git a/src/libraries/System.Memory/src/System/Buffers/ReadOnlySequence.cs b/src/libraries/System.Memory/src/System/Buffers/ReadOnlySequence.cs index 6a84d07..d68bc2d 100644 --- a/src/libraries/System.Memory/src/System/Buffers/ReadOnlySequence.cs +++ b/src/libraries/System.Memory/src/System/Buffers/ReadOnlySequence.cs @@ -111,7 +111,7 @@ namespace System.Buffers } /// - /// Creates an instance of from the . + /// Creates an instance of from the array. /// public ReadOnlySequence(T[] array) { @@ -125,7 +125,7 @@ namespace System.Buffers } /// - /// Creates an instance of from the , start and index. + /// Creates an instance of from the array, start, and index. /// public ReadOnlySequence(T[] array, int start, int length) { diff --git a/src/libraries/System.Net.Primitives/src/System/Net/Sockets/AddressFamily.cs b/src/libraries/System.Net.Primitives/src/System/Net/Sockets/AddressFamily.cs index 1576559..42b84f3 100644 --- a/src/libraries/System.Net.Primitives/src/System/Net/Sockets/AddressFamily.cs +++ b/src/libraries/System.Net.Primitives/src/System/Net/Sockets/AddressFamily.cs @@ -4,12 +4,7 @@ namespace System.Net.Sockets { - /// - /// - /// Specifies the address families that an instance of the - /// class can use. - /// - /// + /// Specifies the addressing scheme that an instance of the Socket class can use. public enum AddressFamily { Unknown = -1, // Unknown diff --git a/src/libraries/System.Reflection.Metadata/src/System/Reflection/Internal/Utilities/ImmutableByteArrayInterop.cs b/src/libraries/System.Reflection.Metadata/src/System/Reflection/Internal/Utilities/ImmutableByteArrayInterop.cs index 2dc3f86..a79a871 100644 --- a/src/libraries/System.Reflection.Metadata/src/System/Reflection/Internal/Utilities/ImmutableByteArrayInterop.cs +++ b/src/libraries/System.Reflection.Metadata/src/System/Reflection/Internal/Utilities/ImmutableByteArrayInterop.cs @@ -24,7 +24,7 @@ namespace System.Reflection.Internal /// This implementation is scoped to byte arrays as that is all that the metadata reader needs. /// /// Also, since we don't have access to immutable collection internals, we use a trick involving - /// overlapping a with a refer. While + /// overlapping a with an array reference. While /// unverifiable, it is valid. See ECMA-335, section II.10.7 Controlling instance layout: /// /// "It is possible to overlap fields in this way, though offsets occupied by an object reference @@ -32,7 +32,7 @@ namespace System.Reflection.Internal /// another object reference. While one object reference can completely overlap another, this is /// unverifiable." /// - /// Furthermore, the fact that backed by a single + /// Furthermore, the fact that backed by a single byte array /// field is something inherent to the design of ImmutableArray in order to get its performance /// characteristics and therefore something we (Microsoft) are comfortable defining as a contract that /// can be depended upon as below. diff --git a/src/libraries/System.Runtime.WindowsRuntime/src/System/Runtime/InteropServices/WindowsRuntime/AsyncInfo.cs b/src/libraries/System.Runtime.WindowsRuntime/src/System/Runtime/InteropServices/WindowsRuntime/AsyncInfo.cs index fa4faba..2288620 100644 --- a/src/libraries/System.Runtime.WindowsRuntime/src/System/Runtime/InteropServices/WindowsRuntime/AsyncInfo.cs +++ b/src/libraries/System.Runtime.WindowsRuntime/src/System/Runtime/InteropServices/WindowsRuntime/AsyncInfo.cs @@ -3,7 +3,6 @@ // See the LICENSE file in the project root for more information. using System.Diagnostics; -using System.Runtime.CompilerServices; using System.Threading; using System.Threading.Tasks; using Windows.Foundation; @@ -22,7 +21,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime #region Factory methods for creating "normal" IAsyncInfo instances backed by a Task created by a pastProvider delegate /// - /// Creates and starts an instance from a function that generates + /// Creates and starts an instance from a function that generates /// a . /// Use this overload if your task supports cancellation in order to hook-up the Cancel /// mechanism exposed by the created asynchronous action and the cancellation of your task. @@ -30,7 +29,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// The function is passed a that the task may monitor /// to be notified of a cancellation request; /// you may ignore the CancellationToken if your task does not support cancellation. - /// An unstarted instance. + /// An unstarted instance. public static IAsyncAction Run(Func taskProvider) { if (taskProvider == null) @@ -41,7 +40,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// - /// Creates and starts an instance from a function + /// Creates and starts an instance from a function /// that generates a . /// Use this overload if your task supports cancellation and progress monitoring is order to: /// (1) hook-up the Cancel mechanism of the created asynchronous action and the cancellation of your task, @@ -53,7 +52,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// you may ignore the CancellationToken if your task does not support cancellation. /// It is also passed a instance to which progress updates may be published; /// you may ignore the IProgress if your task does not support progress reporting. - /// An unstarted instance. + /// An unstarted instance. public static IAsyncActionWithProgress Run(Func, Task> taskProvider) { if (taskProvider == null) @@ -64,7 +63,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// - /// Creates and starts an instance from a function + /// Creates and starts an instance from a function /// that generates a . /// Use this overload if your task supports cancellation in order to hook-up the Cancel /// mechanism exposed by the created asynchronous operation and the cancellation of your task. @@ -72,7 +71,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// The function is passed a that the task may monitor /// to be notified of a cancellation request; /// you may ignore the CancellationToken if your task does not support cancellation. - /// An unstarted instance. + /// An unstarted instance. public static IAsyncOperation Run(Func> taskProvider) { // This is only internal to reduce the number of public overloads. @@ -86,7 +85,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// - /// Creates and starts an instance + /// Creates and starts an instance /// from a function that generates a .
      /// Use this overload if your task supports cancellation and progress monitoring is order to: /// (1) hook-up the Cancel mechanism of the created asynchronous operation and the cancellation of your task, @@ -100,7 +99,7 @@ namespace System.Runtime.InteropServices.WindowsRuntime /// you may ignore the CancellationToken if your task does not support cancellation. /// It is also passed a instance to which progress updates may be published; /// you may ignore the IProgress if your task does not support progress reporting. - /// An unstarted instance. + /// An unstarted instance. public static IAsyncOperationWithProgress Run( Func, Task> taskProvider) { diff --git a/src/libraries/System.Threading.Tasks.Dataflow/src/Base/DataflowBlock.cs b/src/libraries/System.Threading.Tasks.Dataflow/src/Base/DataflowBlock.cs index a2789a7..4a8f40e 100644 --- a/src/libraries/System.Threading.Tasks.Dataflow/src/Base/DataflowBlock.cs +++ b/src/libraries/System.Threading.Tasks.Dataflow/src/Base/DataflowBlock.cs @@ -227,7 +227,7 @@ namespace System.Threading.Tasks.Dataflow #endregion #region Post and SendAsync - /// Posts an item to the . + /// Posts an item to the . /// Specifies the type of data accepted by the target block. /// The target block. /// The item being offered to the target. @@ -235,11 +235,11 @@ namespace System.Threading.Tasks.Dataflow /// /// This method will return once the target block has decided to accept or decline the item, /// but unless otherwise dictated by special semantics of the target block, it does not wait - /// for the item to actually be processed (for example, + /// for the item to actually be processed (for example, /// will return from Post as soon as it has stored the posted item into its input queue). From the perspective /// of the block's processing, Post is asynchronous. For target blocks that support postponing offered messages, /// or for blocks that may do more processing in their Post implementation, consider using - /// SendAsync, + /// SendAsync, /// which will return immediately and will enable the target to postpone the posted message and later consume it /// after SendAsync returns. /// @@ -766,7 +766,7 @@ namespace System.Threading.Tasks.Dataflow #region TryReceive, ReceiveAsync, and Receive #region TryReceive /// - /// Attempts to synchronously receive an item from the . + /// Attempts to synchronously receive an item from the . /// /// The source from which to receive. /// The item received from the source. @@ -2716,7 +2716,7 @@ namespace System.Threading.Tasks.Dataflow /// Gets a target block that synchronously accepts all messages offered to it and drops them. ///       /// The type of the messages this block can accept. - /// A that accepts and subsequently drops all offered messages. + /// A that accepts and subsequently drops all offered messages. public static ITargetBlock NullTarget() { return new NullTargetBlock(); diff --git a/src/libraries/System.Threading.Tasks.Dataflow/src/Blocks/ActionBlock.cs b/src/libraries/System.Threading.Tasks.Dataflow/src/Blocks/ActionBlock.cs index 9c7ba60..79a759b 100644 --- a/src/libraries/System.Threading.Tasks.Dataflow/src/Blocks/ActionBlock.cs +++ b/src/libraries/System.Threading.Tasks.Dataflow/src/Blocks/ActionBlock.cs @@ -250,17 +250,17 @@ namespace System.Threading.Tasks.Dataflow get { return _defaultTarget != null ? _defaultTarget.Completion : _spscTarget.Completion; } } - /// Posts an item to the . + /// Posts an item to the . /// The item being offered to the target. /// true if the item was accepted by the target block; otherwise, false. /// /// This method will return once the target block has decided to accept or decline the item, /// but unless otherwise dictated by special semantics of the target block, it does not wait - /// for the item to actually be processed (for example, + /// for the item to actually be processed (for example, /// will return from Post as soon as it has stored the posted item into its input queue). From the perspective /// of the block's processing, Post is asynchronous. For target blocks that support postponing offered messages, /// or for blocks that may do more processing in their Post implementation, consider using - /// SendAsync, + /// SendAsync, /// which will return immediately and will enable the target to postpone the posted message and later consume it /// after SendAsync returns. /// diff --git a/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/ConcurrentQueue.cs b/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/ConcurrentQueue.cs index ce4f597..8dbac6a 100644 --- a/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/ConcurrentQueue.cs +++ b/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/ConcurrentQueue.cs @@ -79,7 +79,7 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections ///       /// The collection whose elements are copied to the new . - /// The argument is + /// The argument is /// null. public ConcurrentQueue(IEnumerable collection) { @@ -92,14 +92,14 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections } /// - /// Copies the elements of the to an , starting at a particular - /// index. + /// Copies the elements of the to an , starting at a particular + /// index. /// - /// The one-dimensional Array that is the + /// The one-dimensional Array that is the /// destination of the elements copied from the - /// . The Array must have zero-based indexing. + /// . The Array must have zero-based indexing. /// The zero-based index in at which copying /// begins. /// is a null reference (Nothing in @@ -110,10 +110,10 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// is multidimensional. -or- /// does not have zero-based indexing. -or- /// is equal to or greater than the length of the - /// -or- The number of elements in the source is + /// -or- The number of elements in the source is /// greater than the available space from to the end of the destination /// . -or- The type of the source cannot be cast automatically to the type of the + /// cref="System.Collections.ICollection"/> cannot be cast automatically to the type of the /// destination . /// void ICollection.CopyTo(Array array, int index) @@ -132,10 +132,10 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections } /// - /// Gets a value indicating whether access to the is + /// Gets a value indicating whether access to the is /// synchronized with the SyncRoot. /// - /// true if access to the is synchronized + /// true if access to the is synchronized /// with the SyncRoot; otherwise, false. For , this property always /// returns false. bool ICollection.IsSynchronized @@ -150,9 +150,9 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Gets an object that can be used to synchronize access to the . This property is not supported. + /// cref="System.Collections.ICollection"/>. This property is not supported. /// - /// The SyncRoot property is not supported. + /// The SyncRoot property is not supported. object ICollection.SyncRoot { get @@ -164,7 +164,7 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Returns an enumerator that iterates through a collection. /// - /// An that can be used to iterate through the collection. + /// An that can be used to iterate through the collection. IEnumerator IEnumerable.GetEnumerator() { return ((IEnumerable)this).GetEnumerator(); @@ -172,10 +172,10 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Attempts to add an object to the . + /// cref="IProducerConsumerCollection{T}"/>. /// /// The object to add to the . The value can be a null + /// cref="IProducerConsumerCollection{T}"/>. The value can be a null /// reference (Nothing in Visual Basic) for reference types. /// /// true if the object was added successfully; otherwise, false. @@ -190,7 +190,7 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Attempts to remove and return an object from the . + /// cref="IProducerConsumerCollection{T}"/>. /// /// /// When this method returns, if the operation was successful, contains the @@ -261,9 +261,9 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Copies the elements to a new . + /// cref="System.Collections.Generic.List{T}"/>. /// - /// A new containing a snapshot of + /// A new containing a snapshot of /// elements copied from the . private List ToList() { @@ -380,11 +380,11 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Copies the elements to an existing one-dimensional Array, starting at the specified array index. + /// cref="System.Array">Array, starting at the specified array index. /// - /// The one-dimensional Array that is the + /// The one-dimensional Array that is the /// destination of the elements copied from the - /// . The Array must have zero-based + /// . The Array must have zero-based /// indexing. /// The zero-based index in at which copying /// begins. @@ -574,7 +574,7 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// without removing it. /// /// When this method returns, contains an object from - /// the beginning of the or an + /// the beginning of the or an /// unspecified value if the operation failed. /// true if and object was returned successfully; otherwise, false. public bool TryPeek(out T result) diff --git a/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/IProducerConsumerCollection.cs b/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/IProducerConsumerCollection.cs index dc4a161..171f141 100644 --- a/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/IProducerConsumerCollection.cs +++ b/src/libraries/System.Threading.Tasks.Dataflow/src/Internal/IProducerConsumerCollection.cs @@ -30,9 +30,9 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// /// Copies the elements of the to /// an - /// , starting at a specified index. + /// , starting at a specified index. /// - /// The one-dimensional that is the destination of + /// The one-dimensional that is the destination of /// the elements copied from the . /// The array must have zero-based indexing. /// The zero-based index in at which copying @@ -56,7 +56,7 @@ namespace System.Threading.Tasks.Dataflow.Internal.Collections /// The object to add to the . /// true if the object was added successfully; otherwise, false. - /// The was invalid for this collection. + /// The was invalid for this collection. bool TryAdd(T item); /// diff --git a/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/Parallel.cs b/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/Parallel.cs index 2484140..9bf4477 100644 --- a/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/Parallel.cs +++ b/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/Parallel.cs @@ -20,7 +20,7 @@ namespace System.Threading.Tasks { /// /// Stores options that configure the operation of methods on the - /// Parallel class. + /// Parallel class. /// /// /// By default, methods on the Parallel class attempt to utilize all available processors, are non-cancelable, and target @@ -51,7 +51,7 @@ namespace System.Threading.Tasks } /// - /// Gets or sets the TaskScheduler + /// Gets or sets the TaskScheduler /// associated with this instance. Setting this property to null /// indicates that the current scheduler should be used. /// @@ -76,12 +76,12 @@ namespace System.Threading.Tasks /// /// /// The limits the number of concurrent operations run by Parallel method calls that are passed this + /// cref="System.Threading.Tasks.Parallel">Parallel method calls that are passed this /// ParallelOptions instance to the set value, if it is positive. If is -1, then there is no limit placed on the number of concurrently /// running operations. /// - /// + /// /// The exception that is thrown when this is set to 0 or some /// value less than -1. /// @@ -97,15 +97,15 @@ namespace System.Threading.Tasks } /// - /// Gets or sets the CancellationToken + /// Gets or sets the CancellationToken /// associated with this instance. /// /// - /// Providing a CancellationToken - /// to a Parallel method enables the operation to be + /// Providing a CancellationToken + /// to a Parallel method enables the operation to be /// exited early. Code external to the operation may cancel the token, and if the operation observes the /// token being set, it may exit early by throwing an - /// . + /// . /// public CancellationToken CancellationToken { @@ -132,7 +132,7 @@ namespace System.Threading.Tasks /// Provides support for parallel loops and regions. /// /// - /// The class provides library-based data parallel replacements + /// The class provides library-based data parallel replacements /// for common operations such as for loops, for each loops, and execution of a set of statements. /// public static class Parallel @@ -149,12 +149,12 @@ namespace System.Threading.Tasks /// /// Executes each of the provided actions, possibly in parallel. /// - /// An array of Actions to execute. - /// The exception that is thrown when the + /// An array of Actions to execute. + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// array contains a null element. - /// The exception that is thrown when any + /// The exception that is thrown when any /// action in the array throws an exception. /// /// This method can be used to execute a set of operations, potentially in parallel. @@ -171,23 +171,23 @@ namespace System.Threading.Tasks /// /// Executes each of the provided actions, possibly in parallel. /// - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. - /// An array of Actions to execute. - /// The exception that is thrown when the + /// An array of Actions to execute. + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// array contains a null element. - /// The exception that is thrown when - /// the CancellationToken in the + /// The exception that is thrown when + /// the CancellationToken in the /// is set. - /// The exception that is thrown when any + /// The exception that is thrown when any /// action in the array throws an exception. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. /// /// This method can be used to execute a set of operations, potentially in parallel. @@ -382,11 +382,11 @@ namespace System.Threading.Tasks /// The start index, inclusive. /// The end index, exclusive. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -411,11 +411,11 @@ namespace System.Threading.Tasks /// The start index, inclusive. /// The end index, exclusive. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -438,23 +438,23 @@ namespace System.Threading.Tasks /// /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -481,23 +481,23 @@ namespace System.Threading.Tasks /// /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -525,11 +525,11 @@ namespace System.Threading.Tasks /// The start index, inclusive. /// The end index, exclusive. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -555,7 +555,7 @@ namespace System.Threading.Tasks /// which other iterations will not execute. /// /// - /// When a loop is ended prematurely, the that's returned will contain + /// When a loop is ended prematurely, the that's returned will contain /// relevant information about the loop's completion. /// /// @@ -577,11 +577,11 @@ namespace System.Threading.Tasks /// The start index, inclusive. /// The end index, exclusive. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -606,23 +606,23 @@ namespace System.Threading.Tasks /// /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -651,23 +651,23 @@ namespace System.Threading.Tasks /// /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each value in the iteration range: @@ -703,15 +703,15 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -765,15 +765,15 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -822,31 +822,31 @@ namespace System.Threading.Tasks /// The type of the thread-local data. /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -899,31 +899,31 @@ namespace System.Threading.Tasks /// The type of the thread-local data. /// The start index, inclusive. /// The end index, exclusive. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -1016,7 +1016,7 @@ namespace System.Threading.Tasks /// A selector function that returns new thread local state. /// A cleanup function to destroy thread local state. /// Only one of the body arguments may be supplied (i.e. they are exclusive). - /// A structure. + /// A structure. private static ParallelLoopResult ForWorker( int fromInclusive, int toExclusive, ParallelOptions parallelOptions, @@ -1277,7 +1277,7 @@ namespace System.Threading.Tasks /// A selector function that returns new thread local state. /// A cleanup function to destroy thread local state. /// Only one of the body arguments may be supplied (i.e. they are exclusive). - /// A structure. + /// A structure. private static ParallelLoopResult ForWorker64( long fromInclusive, long toExclusive, ParallelOptions parallelOptions, @@ -1526,19 +1526,19 @@ namespace System.Threading.Tasks /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1560,30 +1560,30 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1609,19 +1609,19 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1645,30 +1645,30 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1696,19 +1696,19 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1732,30 +1732,30 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// An enumerable data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// The delegate is invoked once for each element in the @@ -1783,7 +1783,7 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. @@ -1794,17 +1794,17 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -1848,39 +1848,39 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// The type of the thread-local data. /// An enumerable data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -1929,7 +1929,7 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. @@ -1940,17 +1940,17 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -1994,39 +1994,39 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on an + /// Executes a for each operation on an /// in which iterations may run in parallel. /// /// The type of the data in the source. /// The type of the thread-local data. /// An enumerable data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// @@ -2095,7 +2095,7 @@ namespace System.Threading.Tasks /// A selector function that returns new thread local state. /// A cleanup function to destroy thread local state. /// Only one of the bodyXX arguments may be supplied (i.e. they are exclusive). - /// A structure. + /// A structure. private static ParallelLoopResult ForEachWorker( IEnumerable source, ParallelOptions parallelOptions, @@ -2155,7 +2155,7 @@ namespace System.Threading.Tasks /// The loop body for the most generic overload. /// A selector function that returns new thread local state. /// A cleanup function to destroy thread local state. - /// A structure. + /// A structure. private static ParallelLoopResult ForEachWorker( TSource[] array, ParallelOptions parallelOptions, @@ -2214,7 +2214,7 @@ namespace System.Threading.Tasks /// The loop body for the most generic overload. /// A selector function that returns new thread local state. /// A cleanup function to destroy thread local state. - /// A structure. + /// A structure. private static ParallelLoopResult ForEachWorker( IList list, ParallelOptions parallelOptions, @@ -2258,39 +2258,39 @@ namespace System.Threading.Tasks /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The Partitioner that contains the original data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2315,39 +2315,39 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The Partitioner that contains the original data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2374,42 +2374,42 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// OrderablePartitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The OrderablePartitioner that contains the original data source. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when the + /// The exception that is thrown when the /// KeysNormalized property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the OrderablePartitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner do not return the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner return an IList with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() or GetDynamicOrderablePartitions() methods in the /// OrderablePartitioner return an IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2441,7 +2441,7 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . @@ -2452,37 +2452,37 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2528,7 +2528,7 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// OrderablePartitioner in which iterations may run in parallel. /// /// The type of the elements in . @@ -2539,40 +2539,40 @@ namespace System.Threading.Tasks /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when the + /// The exception that is thrown when the /// KeysNormalized property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the OrderablePartitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner do not return the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner return an IList with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() or GetDynamicOrderablePartitions() methods in the /// OrderablePartitioner return an IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2623,50 +2623,50 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The Partitioner that contains the original data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2696,50 +2696,50 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The Partitioner that contains the original data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2771,53 +2771,53 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// OrderablePartitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The OrderablePartitioner that contains the original data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The delegate that is invoked once per iteration. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when the + /// The exception that is thrown when the /// KeysNormalized property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the OrderablePartitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner do not return the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner return an IList with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() or GetDynamicOrderablePartitions() methods in the /// OrderablePartitioner return an IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2854,59 +2854,59 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// Partitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The type of the thread-local data. /// The Partitioner that contains the original data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the Partitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the Partitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner does not return /// the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() method in the Partitioner returns an IList /// with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() method in the Partitioner returns an /// IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// @@ -2957,62 +2957,62 @@ namespace System.Threading.Tasks } /// - /// Executes a for each operation on a + /// Executes a for each operation on a /// OrderablePartitioner in which iterations may run in parallel. /// /// The type of the elements in . /// The type of the thread-local data. /// The OrderablePartitioner that contains the original data source. - /// A ParallelOptions + /// A ParallelOptions /// instance that configures the behavior of this operation. /// The function delegate that returns the initial state of the local data /// for each thread. /// The delegate that is invoked once per iteration. /// The delegate that performs a final action on the local state of each /// thread. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// argument is null. - /// The exception that is thrown when the - /// CancellationToken in the + /// The exception that is thrown when the + /// CancellationToken in the /// argument is set - /// The exception that is thrown when the + /// The exception that is thrown when the /// SupportsDynamicPartitions property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when the + /// The exception that is thrown when the /// KeysNormalized property in the OrderablePartitioner returns /// false. - /// The exception that is thrown when any + /// The exception that is thrown when any /// methods in the OrderablePartitioner return null. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner do not return the correct number of partitions. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetPartitions() or GetOrderablePartitions() methods in the /// OrderablePartitioner return an IList with at least one null value. - /// The exception that is thrown when the + /// The exception that is thrown when the /// GetDynamicPartitions() or GetDynamicOrderablePartitions() methods in the /// OrderablePartitioner return an IEnumerable whose GetEnumerator() method returns null. - /// The exception that is thrown to contain an exception + /// The exception that is thrown to contain an exception /// thrown from one of the specified delegates. - /// The exception that is thrown when the - /// the CancellationTokenSource associated with the - /// the CancellationToken in the + /// The exception that is thrown when the + /// the CancellationTokenSource associated with the + /// the CancellationToken in the /// has been disposed. - /// A ParallelLoopResult structure + /// A ParallelLoopResult structure /// that contains information on what portion of the loop completed. /// /// - /// The Partitioner is used to retrieve + /// The Partitioner is used to retrieve /// the elements to be processed, in place of the original data source. If the current element's - /// index is desired, the source must be an + /// index is desired, the source must be an /// OrderablePartitioner. /// /// diff --git a/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/ParallelLoopState.cs b/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/ParallelLoopState.cs index 1b1921c..f7c8c09 100644 --- a/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/ParallelLoopState.cs +++ b/src/libraries/System.Threading.Tasks.Parallel/src/System/Threading/Tasks/ParallelLoopState.cs @@ -16,7 +16,7 @@ using System.Diagnostics; namespace System.Threading.Tasks { /// - /// Enables iterations of loops to interact with + /// Enables iterations of loops to interact with /// other iterations. /// [DebuggerDisplay("ShouldExitCurrentIteration = {ShouldExitCurrentIteration}")] @@ -120,7 +120,7 @@ namespace System.Threading.Tasks /// Communicates that the loop should cease execution at the system's earliest /// convenience. /// - /// + /// /// The method was previously called. and may not be used in combination by iterations of the same loop. /// @@ -153,7 +153,7 @@ namespace System.Threading.Tasks /// Communicates that the loop should cease execution at the system's earliest /// convenience of iterations beyond the current iteration. /// - /// + /// /// The method was previously called. and /// may not be used in combination by iterations of the same loop. /// @@ -312,7 +312,7 @@ namespace System.Threading.Tasks /// Communicates that parallel tasks should stop when they reach a specified iteration element. /// (which is CurrentIteration of the caller). /// - /// Break() called after Stop(). + /// Break() called after Stop(). /// /// This is shared with all other concurrent threads in the system which are participating in the /// loop's execution. After calling Break(), no additional iterations will be executed on @@ -380,7 +380,7 @@ namespace System.Threading.Tasks /// Communicates that parallel tasks should stop when they reach a specified iteration element. /// (which is CurrentIteration of the caller). /// - /// Break() called after Stop(). + /// Break() called after Stop(). /// /// Atomically sets shared StoppedBroken flag to BROKEN, then atomically sets shared /// LowestBreakIteration to CurrentIteration, but only if CurrentIteration is less than diff --git a/src/libraries/System.Threading/src/System/Threading/Barrier.cs b/src/libraries/System.Threading/src/System/Threading/Barrier.cs index 646846d..1c9d869 100644 --- a/src/libraries/System.Threading/src/System/Threading/Barrier.cs +++ b/src/libraries/System.Threading/src/System/Threading/Barrier.cs @@ -193,7 +193,7 @@ namespace System.Threading /// /// The number of participating threads. /// is less than 0 - /// or greater than . + /// or greater than . public Barrier(int participantCount) : this(participantCount, null) { @@ -203,10 +203,10 @@ namespace System.Threading /// Initializes a new instance of the class. /// /// The number of participating threads. - /// The to be executed after each + /// The to be executed after each /// phase. - /// is less than 0 - /// or greater than . + /// is less than 0 + /// or greater than . /// /// The delegate will be executed after /// all participants have arrived at the barrier in one phase. The participants @@ -275,14 +275,14 @@ namespace System.Threading /// /// The phase number of the barrier in which the new participants will first /// participate. - /// + /// /// Adding a participant would cause the barrier's participant count to - /// exceed . + /// exceed . /// - /// + /// /// The method was invoked from within a post-phase action. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public long AddParticipant() { @@ -303,14 +303,14 @@ namespace System.Threading /// barrier. /// The phase number of the barrier in which the new participants will first /// participate. - /// is less than + /// is less than /// 0. - /// Adding participants would cause the - /// barrier's participant count to exceed . - /// + /// Adding participants would cause the + /// barrier's participant count to exceed . + /// /// The method was invoked from within a post-phase action. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public long AddParticipants(int participantCount) { @@ -393,12 +393,12 @@ namespace System.Threading /// /// Notifies the that there will be one less participant. /// - /// The barrier already has 0 + /// The barrier already has 0 /// participants. - /// + /// /// The method was invoked from within a post-phase action. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public void RemoveParticipant() { @@ -409,13 +409,13 @@ namespace System.Threading /// Notifies the that there will be fewer participants. /// /// The number of additional participants to remove from the barrier. - /// is less than + /// is less than /// 0. - /// The barrier already has 0 participants. - /// + /// The barrier already has 0 participants. + /// /// The method was invoked from within a post-phase action. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public void RemoveParticipants(int participantCount) { @@ -478,11 +478,11 @@ namespace System.Threading /// Signals that a participant has reached the and waits for all other /// participants to reach the barrier as well. /// - /// + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public void SignalAndWait() { @@ -492,17 +492,17 @@ namespace System.Threading /// /// Signals that a participant has reached the and waits for all other /// participants to reach the barrier, while observing a . + /// cref="System.Threading.CancellationToken"/>. /// - /// The to + /// The to /// observe. - /// + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// has been + /// has been /// canceled. - /// The current instance has already been + /// The current instance has already been /// disposed. public void SignalAndWait(CancellationToken cancellationToken) { @@ -518,20 +518,20 @@ namespace System.Threading /// /// Signals that a participant has reached the and waits for all other /// participants to reach the barrier as well, using a - /// to measure the time interval. + /// to measure the time interval. /// - /// A that represents the number of - /// milliseconds to wait, or a that represents -1 milliseconds to + /// A that represents the number of + /// milliseconds to wait, or a that represents -1 milliseconds to /// wait indefinitely. /// true if all other participants reached the barrier; otherwise, false. - /// is a negative number + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out, or it is greater than - /// . - /// + /// . + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public bool SignalAndWait(TimeSpan timeout) { @@ -541,24 +541,24 @@ namespace System.Threading /// /// Signals that a participant has reached the and waits for all other /// participants to reach the barrier as well, using a - /// to measure the time interval, while observing a . + /// to measure the time interval, while observing a . /// - /// A that represents the number of - /// milliseconds to wait, or a that represents -1 milliseconds to + /// A that represents the number of + /// milliseconds to wait, or a that represents -1 milliseconds to /// wait indefinitely. - /// The to + /// The to /// observe. /// true if all other participants reached the barrier; otherwise, false. - /// is a negative number + /// is a negative number /// other than -1 milliseconds, which represents an infinite time-out. - /// + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// has been + /// has been /// canceled. - /// The current instance has already been + /// The current instance has already been /// disposed. public bool SignalAndWait(TimeSpan timeout, CancellationToken cancellationToken) { @@ -579,13 +579,13 @@ namespace System.Threading /// The number of milliseconds to wait, or (-1) to wait indefinitely. /// true if all other participants reached the barrier; otherwise, false. - /// is a + /// is a /// negative number other than -1, which represents an infinite time-out. - /// + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public bool SignalAndWait(int millisecondsTimeout) { @@ -596,22 +596,22 @@ namespace System.Threading /// Signals that a participant has reached the barrier and waits for all other participants to reach /// the barrier as well, using a /// 32-bit signed integer to measure the time interval, while observing a . + /// cref="System.Threading.CancellationToken"/>. /// /// The number of milliseconds to wait, or (-1) to wait indefinitely. - /// The to + /// The to /// observe. /// true if all other participants reached the barrier; otherwise, false. - /// is a + /// is a /// negative number other than -1, which represents an infinite time-out. - /// + /// /// The method was invoked from within a post-phase action, the barrier currently has 0 participants, /// or the barrier is being used by more threads than are registered as participants. /// - /// has been + /// has been /// canceled. - /// The current instance has already been + /// The current instance has already been /// disposed. public bool SignalAndWait(int millisecondsTimeout, CancellationToken cancellationToken) { @@ -892,7 +892,7 @@ namespace System.Threading /// /// Releases all resources used by the current instance of . /// - /// + /// /// The method was invoked from within a post-phase action. /// /// diff --git a/src/libraries/System.Threading/src/System/Threading/CountdownEvent.cs b/src/libraries/System.Threading/src/System/Threading/CountdownEvent.cs index 8c054b6..4ecf05a 100644 --- a/src/libraries/System.Threading/src/System/Threading/CountdownEvent.cs +++ b/src/libraries/System.Threading/src/System/Threading/CountdownEvent.cs @@ -38,12 +38,12 @@ namespace System.Threading private volatile bool _disposed; // Whether the latch has been disposed. /// - /// Initializes a new instance of class with the + /// Initializes a new instance of class with the /// specified count. /// /// The number of signals required to set the . - /// is less + /// cref="System.Threading.CountdownEvent"/>. + /// is less /// than 0. public CountdownEvent(int initialCount) { @@ -108,10 +108,10 @@ namespace System.Threading } /// - /// Gets a that is used to wait for the event to be set. + /// Gets a that is used to wait for the event to be set. /// - /// A that is used to wait for the event to be set. - /// The current instance has already been disposed. + /// A that is used to wait for the event to be set. + /// The current instance has already been disposed. /// /// should only be used if it's needed for integration with code bases /// that rely on having a WaitHandle. If all that's needed is to wait for the @@ -127,7 +127,7 @@ namespace System.Threading } /// - /// Releases all resources used by the current instance of . + /// Releases all resources used by the current instance of . /// /// /// Unlike most of the members of , is not @@ -146,7 +146,7 @@ namespace System.Threading /// /// When overridden in a derived class, releases the unmanaged resources used by the - /// , and optionally releases the managed resources. + /// , and optionally releases the managed resources. /// /// true to release both managed and unmanaged resources; false to release /// only unmanaged resources. @@ -164,14 +164,14 @@ namespace System.Threading } /// - /// Registers a signal with the , decrementing its + /// Registers a signal with the , decrementing its /// count. /// /// true if the signal caused the count to reach zero and the event was set; otherwise, /// false. - /// The current instance is already set. + /// The current instance is already set. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public bool Signal() { @@ -200,19 +200,19 @@ namespace System.Threading } /// - /// Registers multiple signals with the , + /// Registers multiple signals with the , /// decrementing its count by the specified amount. /// /// The number of signals to register. /// true if the signals caused the count to reach zero and the event was set; otherwise, /// false. - /// + /// /// The current instance is already set. -or- Or is greater than . /// - /// is less + /// is less /// than 1. - /// The current instance has already been + /// The current instance has already been /// disposed. public bool Signal(int signalCount) { @@ -257,13 +257,13 @@ namespace System.Threading } /// - /// Increments the 's current count by one. + /// Increments the 's current count by one. /// - /// The current instance is already + /// The current instance is already /// set. - /// is equal to . - /// + /// is equal to . + /// /// The current instance has already been disposed. /// public void AddCount() @@ -272,13 +272,13 @@ namespace System.Threading } /// - /// Attempts to increment the 's current count by one. + /// Attempts to increment the 's current count by one. /// /// true if the increment succeeded; otherwise, false. If is /// already at zero. this will return false. - /// is equal to . - /// The current instance has already been + /// is equal to . + /// The current instance has already been /// disposed. public bool TryAddCount() { @@ -286,17 +286,17 @@ namespace System.Threading } /// - /// Increments the 's current count by a specified + /// Increments the 's current count by a specified /// value. /// /// The value by which to increase . - /// is less than + /// is less than /// 0. - /// The current instance is already + /// The current instance is already /// set. - /// is equal to . - /// The current instance has already been + /// is equal to . + /// The current instance has already been /// disposed. public void AddCount(int signalCount) { @@ -307,19 +307,19 @@ namespace System.Threading } /// - /// Attempts to increment the 's current count by a + /// Attempts to increment the 's current count by a /// specified value. /// /// The value by which to increase . /// true if the increment succeeded; otherwise, false. If is /// already at zero this will return false. - /// is less + /// is less /// than 0. - /// The current instance is already + /// The current instance is already /// set. - /// is equal to . - /// The current instance has already been + /// is equal to . + /// The current instance has already been /// disposed. public bool TryAddCount(int signalCount) { @@ -365,7 +365,7 @@ namespace System.Threading /// Unlike most of the members of , Reset is not /// thread-safe and may not be used concurrently with other members of this instance. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public void Reset() { @@ -376,14 +376,14 @@ namespace System.Threading /// Resets the to a specified value. /// /// The number of signals required to set the . + /// cref="System.Threading.CountdownEvent"/>. /// /// Unlike most of the members of , Reset is not /// thread-safe and may not be used concurrently with other members of this instance. /// - /// is + /// is /// less than 0. - /// The current instance has already been disposed. + /// The current instance has already been disposed. public void Reset(int count) { ThrowIfDisposed(); @@ -407,13 +407,13 @@ namespace System.Threading } /// - /// Blocks the current thread until the is set. + /// Blocks the current thread until the is set. /// /// /// The caller of this method blocks indefinitely until the current instance is set. The caller will /// return immediately if the event is currently in a set state. /// - /// The current instance has already been + /// The current instance has already been /// disposed. public void Wait() { @@ -422,21 +422,21 @@ namespace System.Threading /// - /// Blocks the current thread until the is set, while - /// observing a . + /// Blocks the current thread until the is set, while + /// observing a . /// - /// The to + /// The to /// observe. /// /// The caller of this method blocks indefinitely until the current instance is set. The caller will /// return immediately if the event is currently in a set state. If the - /// CancellationToken being observed - /// is canceled during the wait operation, an + /// CancellationToken being observed + /// is canceled during the wait operation, an /// will be thrown. /// - /// has been + /// has been /// canceled. - /// The current instance has already been + /// The current instance has already been /// disposed. public void Wait(CancellationToken cancellationToken) { @@ -444,18 +444,18 @@ namespace System.Threading } /// - /// Blocks the current thread until the is set, using a - /// to measure the time interval. + /// Blocks the current thread until the is set, using a + /// to measure the time interval. /// - /// A that represents the number of - /// milliseconds to wait, or a that represents -1 milliseconds to + /// A that represents the number of + /// milliseconds to wait, or a that represents -1 milliseconds to /// wait indefinitely. /// true if the was set; otherwise, /// false. - /// is a negative + /// is a negative /// number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater /// than . - /// The current instance has already been + /// The current instance has already been /// disposed. public bool Wait(TimeSpan timeout) { @@ -469,23 +469,23 @@ namespace System.Threading } /// - /// Blocks the current thread until the is set, using - /// a to measure the time interval, while observing a - /// . + /// Blocks the current thread until the is set, using + /// a to measure the time interval, while observing a + /// . /// - /// A that represents the number of - /// milliseconds to wait, or a that represents -1 milliseconds to + /// A that represents the number of + /// milliseconds to wait, or a that represents -1 milliseconds to /// wait indefinitely. - /// The to + /// The to /// observe. /// true if the was set; otherwise, /// false. - /// is a negative + /// is a negative /// number other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater /// than . - /// The current instance has already been + /// The current instance has already been /// disposed. - /// has + /// has /// been canceled. public bool Wait(TimeSpan timeout, CancellationToken cancellationToken) { @@ -499,7 +499,7 @@ namespace System.Threading } /// - /// Blocks the current thread until the is set, using a + /// Blocks the current thread until the is set, using a /// 32-bit signed integer to measure the time interval. /// /// The number of milliseconds to wait, or /// is a /// negative number other than -1, which represents an infinite time-out. - /// The current instance has already been + /// The current instance has already been /// disposed. public bool Wait(int millisecondsTimeout) { @@ -516,21 +516,21 @@ namespace System.Threading } /// - /// Blocks the current thread until the is set, using a + /// Blocks the current thread until the is set, using a /// 32-bit signed integer to measure the time interval, while observing a - /// . + /// . /// /// The number of milliseconds to wait, or (-1) to wait indefinitely. - /// The to + /// The to /// observe. /// true if the was set; otherwise, /// false. /// is a /// negative number other than -1, which represents an infinite time-out. - /// The current instance has already been + /// The current instance has already been /// disposed. - /// has + /// has /// been canceled. public bool Wait(int millisecondsTimeout, CancellationToken cancellationToken) { -- 2.7.4