Class EtoTaskHandlerBase

Namespace

NanoByte.Common.Tasks

Assembly

NanoByte.Common.EtoForms.dll

Common base class for Eto.Forms ITaskHandler implementations.

[MustDisposeResource]
public abstract class EtoTaskHandlerBase : TaskHandlerBase, ITaskHandler, IDisposable

Inheritance

object

TaskHandlerBase

EtoTaskHandlerBase

Implements

ITaskHandler

IDisposable

Derived

EtoDialogTaskHandler

Inherited Members

TaskHandlerBase.Dispose()

TaskHandlerBase.LogHandler(LogSeverity, string, Exception)

TaskHandlerBase.CancellationTokenSource

TaskHandlerBase.CancellationToken

TaskHandlerBase.Verbosity

TaskHandlerBase.RunTask(ITask)

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, Stream, string?)

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

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

UpdateUtils.To<T>(T, ref T, Action)

UpdateUtils.To<T>(T, ref T, ref bool)

UpdateUtils.To<T>(T, ref T, ref bool, ref bool)

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

ConversionUtils.ConvertToString<TType>(TType)

JsonStorage.ReparseAsJson<T>(object)

JsonStorage.ReparseAsJson<T>(object, T)

Remarks

This class is thread-safe.

Fields

LogRichText

Aggregated Log entries for later display.

protected readonly FormattedTextBuilder LogRichText

Field Value

FormattedTextBuilder

Properties

CredentialProvider

Used to ask the user or a keyring for NetworkCredentials for specific Uris; can be null.

protected override ICredentialProvider CredentialProvider { get; }

Property Value

ICredentialProvider

IsInteractive

Indicates whether the user can provide input.

protected override bool IsInteractive { get; }

Property Value

bool

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'.

DisplayLogEntry(LogSeverity, string)

Aggregates Log entries in LogRichText for later display.

protected override void DisplayLogEntry(LogSeverity severity, string message)

Parameters

severity LogSeverity

message string

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, NamedCollection<T>)

Displays tree-like data to the user.

public override void Output<T>(string title, NamedCollection<T> data) where T : INamed

Parameters

title string

A title for the data.

data NamedCollection<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.

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.