Export (0) Print
Expand All

ParallelMergeOptions Enumeration

Specifies the preferred type of output merge to use in a query. In other words, it indicates how PLINQ should merge the results from the various partitions back into a single result sequence. This is a hint only, and may not be respected by the system when parallelizing all queries.

Namespace:  System.Linq
Assemblies:   System.Core (in System.Core.dll)
  System.Linq.Parallel (in System.Linq.Parallel.dll)

public enum ParallelMergeOptions

Member nameDescription
Supported by Portable Class LibraryAutoBufferedUse a merge with output buffers of a size chosen by the system. Results will accumulate into an output buffer before they are available to the consumer of the query.
Supported by Portable Class LibraryDefaultUse the default merge type, which is AutoBuffered.
Supported by Portable Class LibraryFullyBufferedUse a merge with full output buffers. The system will accumulate all of the results before making any of them available to the consumer of the query.
Supported by Portable Class LibraryNotBufferedUse a merge without output buffers. As soon as result elements have been computed, make that element available to the consumer of the query.

Use NotBuffered for queries that will be consumed and output as streams, this has the lowest latency between beginning query execution and elements being yielded. For some queries, such as those involving a sort (OrderBy, OrderByDescending), buffering is essential and a hint of NotBuffered or AutoBuffered will be ignored. However, queries that are created by using the AsOrdered operator can be streamed as long as no further sorting is performed within the query itself.

Use AutoBuffered for most cases; this is the default. It strikes a balance between latency and overall performance.

Use FullyBuffered for queries when the entire output can be processed before the information is needed. This option offers the best performance when all of the output can be accumulated before yielding any information, though it is not suitable for stream processing or showing partial results mid-query.

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1
Show:
© 2015 Microsoft