Class DialogTaskHandler

Namespace

NanoByte.Common.Tasks

Assembly

NanoByte.Common.WinForms.dll

Uses simple WinForms dialog boxes to inform the user about the progress of tasks.

[MustDisposeResource]
public class DialogTaskHandler : GuiTaskHandlerBase, ITaskHandler

Inheritance

object

TaskHandlerBase

GuiTaskHandlerBase

DialogTaskHandler

Implements

ITaskHandler

Inherited Members

GuiTaskHandlerBase.LogRtf

GuiTaskHandlerBase.DisplayLogEntry(LogSeverity, string)

GuiTaskHandlerBase.GetLogColor(LogSeverity)

GuiTaskHandlerBase.CredentialProvider

GuiTaskHandlerBase.IsInteractive

GuiTaskHandlerBase.Output<T>(string, NamedCollection<T>)

TaskHandlerBase.Dispose()

TaskHandlerBase.LogHandler(LogSeverity, string, Exception)

TaskHandlerBase.CancellationTokenSource

TaskHandlerBase.CancellationToken

TaskHandlerBase.Verbosity

TaskHandlerBase.Ask(string, bool?, string)

Extension Methods

BinaryStorage.SaveBinary<T>(T, Stream)

BinaryStorage.SaveBinary<T>(T, string)

JsonStorage.SaveJson<T>(T, Stream)

JsonStorage.SaveJson<T>(T, string)

JsonStorage.ToJsonString<T>(T)

XmlStorage.SaveXml<T>(T, string, string?)

UpdateUtils.To<TIn, TOut>(TIn, Func<TIn, TOut>)

ConversionUtils.ConvertToString<TType>(TType)

JsonStorage.ReparseAsJson<T>(object)

JsonStorage.ReparseAsJson<T>(object, T)

XmlStorage.SaveXml(object, Stream, string?)

XmlStorage.ToXmlString(object, string?)

Remarks

This class is thread-safe.

Constructors

DialogTaskHandler(Control)

Creates a new dialog task handler. Registers a Handler.

public DialogTaskHandler(Control owner)

Parameters

owner Control

The parent window for any dialogs created by the handler.

Methods

AskInteractive(string, bool)

Asks the user a Yes/No/Cancel question.

protected override bool AskInteractive(string question, bool defaultAnswer)

Parameters

question string

The question and comprehensive information to help the user make an informed decision.

defaultAnswer bool

The default answer to preselect.

Returns

bool

true if the user answered with 'Yes'; false if the user answered with 'No'.

Exceptions

OperationCanceledException

Throw if the user answered with 'Cancel'.

Error(Exception)

Displays an error message to the user.

public override void Error(Exception exception)

Parameters

exception Exception

The exception representing the error that occurred.

Output(string, string)

Displays multi-line text to the user.

public override void Output(string title, string message)

Parameters

title string

A title for the message.

message string

The string to display. Trailing linebreaks are appropriately handled or ignored.

Remarks

Implementations may close the UI as a side effect. Therefore this should be your last call on the handler.

Output<T>(string, IEnumerable<T>)

Displays tabular data to the user.

public override void Output<T>(string title, IEnumerable<T> data)

Parameters

title string

A title for the data.

data IEnumerable<T>

The data to display.

Type Parameters

T

Remarks

Implementations may close the UI as a side effect. Therefore this should be your last call on the handler.

RunTask(ITask)

Runs an ITask and tracks its progress. Returns once the task has been completed.

public override void RunTask(ITask task)

Parameters

task ITask

The task to be run. (Run(CancellationToken, ICredentialProvider?, IProgress<TaskSnapshot>?) or equivalent is called on it.)

Exceptions

OperationCanceledException

The user canceled the task.

IOException

The task ended with IOError.

WebException

The task ended with WebError.