#### [PromptPlus](PromptPlus.md 'PromptPlus') ### [PromptPlusLibrary](PromptPlusLibrary.md 'PromptPlusLibrary') ## IMultiTasksControl Interface Provides a fluent API for configuring and running a MultiTasks control that executes several synchronous or asynchronous tasks \(sequentially or in parallel\), presenting a paginated execution list with waiting / running / success / failure status indicators\. ```csharp public interface IMultiTasksControl ``` ### Remarks Each task receives an isolated read\-only input context and returns a separate isolated output context\. Every configuration method returns the same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance so the calls can be chained \(fluent style\)\. Call [Run\(CancellationToken\)](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Run(System.Threading.CancellationToken) 'PromptPlusLibrary\.IMultiTasksControl\.Run\(System\.Threading\.CancellationToken\)') last to display the control and block until all tasks finish\. ### Methods ## IMultiTasksControl\.AddTask\(string, Action\, Nullable\\) Method Adds a simple synchronous task with the given title, without input or output context\. ```csharp PromptPlusLibrary.IMultiTasksControl AddTask(string title, System.Action handler, System.Nullable mode=null); ``` #### Parameters `title` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String') The task title displayed in the list\. Cannot be `null`\. `handler` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')[System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1') The task callback\. Cannot be `null`\. `mode` [System\.Nullable<](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')[MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode')[>](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1') Optional execution mode for this task\. When `null`, the default from [Mode\(MultiTasksMode\)](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Mode(PromptPlusLibrary.MultiTasksMode) 'PromptPlusLibrary\.IMultiTasksControl\.Mode\(PromptPlusLibrary\.MultiTasksMode\)') is used\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [title](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTask(string,System.Action_System.Threading.CancellationToken_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).title 'PromptPlusLibrary\.IMultiTasksControl\.AddTask\(string, System\.Action\, System\.Nullable\\)\.title') or [handler](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTask(string,System.Action_System.Threading.CancellationToken_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).handler 'PromptPlusLibrary\.IMultiTasksControl\.AddTask\(string, System\.Action\, System\.Nullable\\)\.handler') is `null`\. ## IMultiTasksControl\.AddTask\(string, Func\,CancellationToken,IDictionary\\>, IDictionary\, Nullable\\) Method Adds a synchronous task with the given title, receiving an isolated read\-only input context and returning an isolated output context \(or `null`\)\. ```csharp PromptPlusLibrary.IMultiTasksControl AddTask(string title, System.Func,System.Threading.CancellationToken,System.Collections.Generic.IDictionary?> handler, System.Collections.Generic.IDictionary? context=null, System.Nullable mode=null); ``` #### Parameters `title` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String') The task title displayed in the list\. Cannot be `null`\. `handler` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Collections\.Generic\.IReadOnlyDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Collections\.Generic\.IDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3') The task callback\. Cannot be `null`\. `context` [System\.Collections\.Generic\.IDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2') Optional isolated input context for this task\. `mode` [System\.Nullable<](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')[MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode')[>](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1') Optional execution mode for this task\. When `null`, the default from [Mode\(MultiTasksMode\)](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Mode(PromptPlusLibrary.MultiTasksMode) 'PromptPlusLibrary\.IMultiTasksControl\.Mode\(PromptPlusLibrary\.MultiTasksMode\)') is used\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [title](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTask(string,System.Func_System.Collections.Generic.IReadOnlyDictionary_string,object_,System.Threading.CancellationToken,System.Collections.Generic.IDictionary_string,object__,System.Collections.Generic.IDictionary_string,object_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).title 'PromptPlusLibrary\.IMultiTasksControl\.AddTask\(string, System\.Func\,System\.Threading\.CancellationToken,System\.Collections\.Generic\.IDictionary\\>, System\.Collections\.Generic\.IDictionary\, System\.Nullable\\)\.title') or [handler](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTask(string,System.Func_System.Collections.Generic.IReadOnlyDictionary_string,object_,System.Threading.CancellationToken,System.Collections.Generic.IDictionary_string,object__,System.Collections.Generic.IDictionary_string,object_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).handler 'PromptPlusLibrary\.IMultiTasksControl\.AddTask\(string, System\.Func\,System\.Threading\.CancellationToken,System\.Collections\.Generic\.IDictionary\\>, System\.Collections\.Generic\.IDictionary\, System\.Nullable\\)\.handler') is `null`\. ## IMultiTasksControl\.AddTaskAsync\(string, Func\,CancellationToken,Task\\>\>, IDictionary\, Nullable\\) Method Adds an asynchronous task with the given title, receiving an isolated read\-only input context and returning an isolated output context \(or `null`\)\. ```csharp PromptPlusLibrary.IMultiTasksControl AddTaskAsync(string title, System.Func,System.Threading.CancellationToken,System.Threading.Tasks.Task?>> handler, System.Collections.Generic.IDictionary? context=null, System.Nullable mode=null); ``` #### Parameters `title` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String') The task title displayed in the list\. Cannot be `null`\. `handler` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Collections\.Generic\.IReadOnlyDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 'System\.Collections\.Generic\.IReadOnlyDictionary\`2')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3')[System\.Threading\.Tasks\.Task<](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[System\.Collections\.Generic\.IDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[>](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1 'System\.Threading\.Tasks\.Task\`1')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-3 'System\.Func\`3') The asynchronous task callback\. Cannot be `null`\. `context` [System\.Collections\.Generic\.IDictionary<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String')[,](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2')[System\.Object](https://learn.microsoft.com/en-us/dotnet/api/system.object 'System\.Object')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.idictionary-2 'System\.Collections\.Generic\.IDictionary\`2') Optional isolated input context for this task\. `mode` [System\.Nullable<](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')[MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode')[>](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1') Optional execution mode for this task\. When `null`, the default from [Mode\(MultiTasksMode\)](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Mode(PromptPlusLibrary.MultiTasksMode) 'PromptPlusLibrary\.IMultiTasksControl\.Mode\(PromptPlusLibrary\.MultiTasksMode\)') is used\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [title](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTaskAsync(string,System.Func_System.Collections.Generic.IReadOnlyDictionary_string,object_,System.Threading.CancellationToken,System.Threading.Tasks.Task_System.Collections.Generic.IDictionary_string,object___,System.Collections.Generic.IDictionary_string,object_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).title 'PromptPlusLibrary\.IMultiTasksControl\.AddTaskAsync\(string, System\.Func\,System\.Threading\.CancellationToken,System\.Threading\.Tasks\.Task\\>\>, System\.Collections\.Generic\.IDictionary\, System\.Nullable\\)\.title') or [handler](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTaskAsync(string,System.Func_System.Collections.Generic.IReadOnlyDictionary_string,object_,System.Threading.CancellationToken,System.Threading.Tasks.Task_System.Collections.Generic.IDictionary_string,object___,System.Collections.Generic.IDictionary_string,object_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).handler 'PromptPlusLibrary\.IMultiTasksControl\.AddTaskAsync\(string, System\.Func\,System\.Threading\.CancellationToken,System\.Threading\.Tasks\.Task\\>\>, System\.Collections\.Generic\.IDictionary\, System\.Nullable\\)\.handler') is `null`\. ## IMultiTasksControl\.AddTaskAsync\(string, Func\, Nullable\\) Method Adds a simple asynchronous task with the given title, without input or output context\. ```csharp PromptPlusLibrary.IMultiTasksControl AddTaskAsync(string title, System.Func handler, System.Nullable mode=null); ``` #### Parameters `title` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String') The task title displayed in the list\. Cannot be `null`\. `handler` [System\.Func<](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken')[,](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2')[System\.Threading\.Tasks\.Task](https://learn.microsoft.com/en-us/dotnet/api/system.threading.tasks.task 'System\.Threading\.Tasks\.Task')[>](https://learn.microsoft.com/en-us/dotnet/api/system.func-2 'System\.Func\`2') The asynchronous task callback\. Cannot be `null`\. `mode` [System\.Nullable<](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1')[MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode')[>](https://learn.microsoft.com/en-us/dotnet/api/system.nullable-1 'System\.Nullable\`1') Optional execution mode for this task\. When `null`, the default from [Mode\(MultiTasksMode\)](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Mode(PromptPlusLibrary.MultiTasksMode) 'PromptPlusLibrary\.IMultiTasksControl\.Mode\(PromptPlusLibrary\.MultiTasksMode\)') is used\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [title](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTaskAsync(string,System.Func_System.Threading.CancellationToken,System.Threading.Tasks.Task_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).title 'PromptPlusLibrary\.IMultiTasksControl\.AddTaskAsync\(string, System\.Func\, System\.Nullable\\)\.title') or [handler](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.AddTaskAsync(string,System.Func_System.Threading.CancellationToken,System.Threading.Tasks.Task_,System.Nullable_PromptPlusLibrary.MultiTasksMode_).handler 'PromptPlusLibrary\.IMultiTasksControl\.AddTaskAsync\(string, System\.Func\, System\.Nullable\\)\.handler') is `null`\. ## IMultiTasksControl\.Culture\(CultureInfo\) Method Sets the culture used to format elapsed time values\. ```csharp PromptPlusLibrary.IMultiTasksControl Culture(System.Globalization.CultureInfo culture); ``` #### Parameters `culture` [System\.Globalization\.CultureInfo](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo 'System\.Globalization\.CultureInfo') The [System\.Globalization\.CultureInfo](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo 'System\.Globalization\.CultureInfo') to use\. Cannot be `null`\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [culture](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Culture(System.Globalization.CultureInfo).culture 'PromptPlusLibrary\.IMultiTasksControl\.Culture\(System\.Globalization\.CultureInfo\)\.culture') is `null`\. ## IMultiTasksControl\.Interaction\\(IEnumerable\, Action\\) Method Iterates a collection and lets the caller register one or more tasks per item, enabling more complex scenarios \(mirrors the Interaction pattern used by other controls\)\. ```csharp PromptPlusLibrary.IMultiTasksControl Interaction(System.Collections.Generic.IEnumerable items, System.Action interactionAction); ``` #### Type parameters `T` The item type\. #### Parameters `items` [System\.Collections\.Generic\.IEnumerable<](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1')[T](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Interaction_T_(System.Collections.Generic.IEnumerable_T_,System.Action_T,PromptPlusLibrary.IMultiTasksControl_).T 'PromptPlusLibrary\.IMultiTasksControl\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\)\.T')[>](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ienumerable-1 'System\.Collections\.Generic\.IEnumerable\`1') The items to iterate\. Cannot be `null`\. `interactionAction` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2')[T](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Interaction_T_(System.Collections.Generic.IEnumerable_T_,System.Action_T,PromptPlusLibrary.IMultiTasksControl_).T 'PromptPlusLibrary\.IMultiTasksControl\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\)\.T')[,](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2')[IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-2 'System\.Action\`2') A callback receiving each item and this control to register tasks\. Cannot be `null`\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [items](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Interaction_T_(System.Collections.Generic.IEnumerable_T_,System.Action_T,PromptPlusLibrary.IMultiTasksControl_).items 'PromptPlusLibrary\.IMultiTasksControl\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\)\.items') or [interactionAction](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Interaction_T_(System.Collections.Generic.IEnumerable_T_,System.Action_T,PromptPlusLibrary.IMultiTasksControl_).interactionAction 'PromptPlusLibrary\.IMultiTasksControl\.Interaction\\(System\.Collections\.Generic\.IEnumerable\, System\.Action\\)\.interactionAction') is `null`\. ## IMultiTasksControl\.MaxDegreeOfParallelism\(int\) Method Sets the maximum number of tasks that can run concurrently in [Parallel](MultiTasksMode.md#PromptPlusLibrary.MultiTasksMode.Parallel 'PromptPlusLibrary\.MultiTasksMode\.Parallel') mode\. The value is clamped to a sensible range based on the available CPU cores\. Use `0` to auto\-select a value derived from [System\.Environment\.ProcessorCount](https://learn.microsoft.com/en-us/dotnet/api/system.environment.processorcount 'System\.Environment\.ProcessorCount')\. ```csharp PromptPlusLibrary.IMultiTasksControl MaxDegreeOfParallelism(int value); ``` #### Parameters `value` [System\.Int32](https://learn.microsoft.com/en-us/dotnet/api/system.int32 'System\.Int32') The maximum degree of parallelism, or `0` to auto\-select\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ## IMultiTasksControl\.Mode\(MultiTasksMode\) Method Sets the default execution mode used by tasks that do not specify their own mode\. Default is [Sequential](MultiTasksMode.md#PromptPlusLibrary.MultiTasksMode.Sequential 'PromptPlusLibrary\.MultiTasksMode\.Sequential')\. ```csharp PromptPlusLibrary.IMultiTasksControl Mode(PromptPlusLibrary.MultiTasksMode mode); ``` #### Parameters `mode` [MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode') The default [MultiTasksMode](MultiTasksMode.md 'PromptPlusLibrary\.MultiTasksMode') to use\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ### Remarks Tasks execute strictly in the order they were added\. Consecutive tasks that resolve to [Parallel](MultiTasksMode.md#PromptPlusLibrary.MultiTasksMode.Parallel 'PromptPlusLibrary\.MultiTasksMode\.Parallel') form a sub\-set that runs concurrently; the run only advances to the next task/sub\-set once every item of the current sub\-set has finished\. A [Sequential](MultiTasksMode.md#PromptPlusLibrary.MultiTasksMode.Sequential 'PromptPlusLibrary\.MultiTasksMode\.Sequential') task runs on its own before the next one starts\. The list order is always preserved \(tasks are never reordered/grouped globally by mode\)\. ## IMultiTasksControl\.Options\(Action\\) Method Applies the shared control options \(such as prompt message, tooltips and abort behavior\)\. ```csharp PromptPlusLibrary.IMultiTasksControl Options(System.Action options); ``` #### Parameters `options` [System\.Action<](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1')[IControlOptions](IControlOptions.md 'PromptPlusLibrary\.IControlOptions')[>](https://learn.microsoft.com/en-us/dotnet/api/system.action-1 'System\.Action\`1') A callback used to configure the [IControlOptions](IControlOptions.md 'PromptPlusLibrary\.IControlOptions')\. Cannot be `null`\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. #### Exceptions [System\.ArgumentNullException](https://learn.microsoft.com/en-us/dotnet/api/system.argumentnullexception 'System\.ArgumentNullException') Thrown when [options](IMultiTasksControl.md#PromptPlusLibrary.IMultiTasksControl.Options(System.Action_PromptPlusLibrary.IControlOptions_).options 'PromptPlusLibrary\.IMultiTasksControl\.Options\(System\.Action\\)\.options') is `null`\. ## IMultiTasksControl\.PageSize\(byte\) Method Sets the maximum number of visible task rows per page\. A value of `0` auto\-fits to the console height\. ```csharp PromptPlusLibrary.IMultiTasksControl PageSize(byte value); ``` #### Parameters `value` [System\.Byte](https://learn.microsoft.com/en-us/dotnet/api/system.byte 'System\.Byte') The desired page size\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ## IMultiTasksControl\.Run\(CancellationToken\) Method Executes all tasks, blocks until they complete or the run is aborted, and returns the final state\. ```csharp PromptPlusLibrary.ResultPrompt Run(System.Threading.CancellationToken token=default(System.Threading.CancellationToken)); ``` #### Parameters `token` [System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken') A [System\.Threading\.CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken 'System\.Threading\.CancellationToken') used to cancel the run while it is executing\. #### Returns [PromptPlusLibrary\.ResultPrompt<](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\')[StateMultiTasks](StateMultiTasks.md 'PromptPlusLibrary\.StateMultiTasks')[>](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\') A [ResultPrompt<T>](ResultPrompt_T_.md 'PromptPlusLibrary\.ResultPrompt\') containing the final [StateMultiTasks](StateMultiTasks.md 'PromptPlusLibrary\.StateMultiTasks')\. ## IMultiTasksControl\.ShowElapsedTime\(bool, string\) Method Shows the elapsed time next to each task\. Enabled by default\. ```csharp PromptPlusLibrary.IMultiTasksControl ShowElapsedTime(bool value=true, string? format=null); ``` #### Parameters `value` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean') `true` to display per\-task elapsed time; otherwise, `false`\. `format` [System\.String](https://learn.microsoft.com/en-us/dotnet/api/system.string 'System\.String') Optional [System\.TimeSpan](https://learn.microsoft.com/en-us/dotnet/api/system.timespan 'System\.TimeSpan') format string\. Default is `hh\:mm\:ss`\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ## IMultiTasksControl\.Spinner\(SpinnersType\) Method Displays an animated spinner in the summary line while at least one task is running\. ```csharp PromptPlusLibrary.IMultiTasksControl Spinner(PromptPlusLibrary.SpinnersType spinnersType); ``` #### Parameters `spinnersType` [SpinnersType](SpinnersType.md 'PromptPlusLibrary\.SpinnersType') The [SpinnersType](SpinnersType.md 'PromptPlusLibrary\.SpinnersType') to display\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ## IMultiTasksControl\.StopOnError\(bool\) Method In sequential mode, stops the remaining tasks when a task fails\. Ignored in parallel mode\. ```csharp PromptPlusLibrary.IMultiTasksControl StopOnError(bool value=true); ``` #### Parameters `value` [System\.Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean 'System\.Boolean') `true` to stop on the first failure; otherwise, `false`\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\. ## IMultiTasksControl\.Styles\(MultiTasksStyles, Style\) Method Overrides the visual style applied to a specific region of the MultiTasks control\. ```csharp PromptPlusLibrary.IMultiTasksControl Styles(PromptPlusLibrary.MultiTasksStyles styleType, ConsolePlusLibrary.Style style); ``` #### Parameters `styleType` [MultiTasksStyles](MultiTasksStyles.md 'PromptPlusLibrary\.MultiTasksStyles') The [MultiTasksStyles](MultiTasksStyles.md 'PromptPlusLibrary\.MultiTasksStyles') region whose style is overridden\. `style` [ConsolePlusLibrary\.Style](https://learn.microsoft.com/en-us/dotnet/api/consolepluslibrary.style 'ConsolePlusLibrary\.Style') The [ConsolePlusLibrary\.Style](https://learn.microsoft.com/en-us/dotnet/api/consolepluslibrary.style 'ConsolePlusLibrary\.Style') to apply\. #### Returns [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') The same [IMultiTasksControl](IMultiTasksControl.md 'PromptPlusLibrary\.IMultiTasksControl') instance for chaining\.