// Public Methods (14)
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionState">Der Wert für den ersten Parameter von <paramref name="action" />.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" /> und/oder <paramref name="action" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
T actionState)
{
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: f => actionState));
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionState">Der Wert für den ersten Parameter von <paramref name="action" />.</param>
/// <param name="cancellationToken">Das Token zum Abbrechen des Tasks.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" /> und/oder <paramref name="action" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
T actionState,
CancellationToken cancellationToken)
{
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: f => actionState,
cancellationToken: cancellationToken));
}
internal StartNewTaskState(TaskFactory taskFactory,
StartNewTaskAction <T> action,
Func <TaskFactory, T> actionStateFactory,
CancellationToken cancellationToken)
{
this.ACTION = action;
this.ACTION_STATE_FACTORY = actionStateFactory;
this.TASK_FACTORY = taskFactory;
this.CANCELLATION_TOKEN = cancellationToken;
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionState">Der Wert für den ersten Parameter von <paramref name="action" />.</param>
/// <param name="scheduler">Der zugrundeliegende Scheduler.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" />, <paramref name="action" /> und/oder
/// <paramref name="scheduler" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
T actionState,
TaskScheduler scheduler)
{
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: f => actionState,
scheduler: scheduler));
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionState">Der Wert für den ersten Parameter von <paramref name="action" />.</param>
/// <param name="creationOptions">Die Optionen zum Erstellen des Tasks.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" /> und/oder <paramref name="action" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
T actionState,
TaskCreationOptions creationOptions)
{
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: f => actionState,
creationOptions: creationOptions));
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionState">Der Wert für den ersten Parameter von <paramref name="action" />.</param>
/// <param name="cancellationToken">Das Token zum Abbrechen des Tasks.</param>
/// <param name="creationOptions">Die Optionen zum Erstellen des Tasks.</param>
/// <param name="scheduler">Der zugrundeliegende Scheduler.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" />, <paramref name="action" /> und/oder
/// <paramref name="scheduler" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
T actionState,
CancellationToken cancellationToken,
TaskCreationOptions creationOptions,
TaskScheduler scheduler)
{
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: f => actionState,
cancellationToken: cancellationToken,
creationOptions: creationOptions,
scheduler: scheduler));
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionStateFactory">Die Funktion, die den Wert für den ersten Parameter von <paramref name="action" /> liefert.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" />, <paramref name="action" /> und/oder
/// <paramref name="actionStateFactory" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
Func <TaskFactory, T> actionStateFactory)
{
if (factory == null)
{
throw new ArgumentNullException("factory");
}
return(StartNewTask <T>(factory: factory,
action: action,
actionStateFactory: actionStateFactory,
cancellationToken: factory.CancellationToken,
creationOptions: factory.CreationOptions,
scheduler: factory.Scheduler ?? TaskScheduler.Default));
}
/// <summary>
/// Wrapper für <see cref="TaskFactory.StartNew(Action{object}, object, CancellationToken, TaskCreationOptions, TaskScheduler)" />
/// mit typisiertem State-Objekt für <paramref name="action" />.
/// </summary>
/// <typeparam name="T">Typ des ersten Parameters von <paramref name="action" />.</typeparam>
/// <param name="factory">Die zugrundeliegende Task-Factory.</param>
/// <param name="action">Die Logik, die ausgeführt werden soll.</param>
/// <param name="actionStateFactory">Die Funktion, die den Wert für den ersten Parameter von <paramref name="action" /> liefert.</param>
/// <param name="cancellationToken">Das Token zum Abbrechen des Tasks.</param>
/// <param name="creationOptions">Die Optionen zum Erstellen des Tasks.</param>
/// <param name="scheduler">Der zugrundeliegende Scheduler.</param>
/// <returns>Der neue Task.</returns>
/// <exception cref="ArgumentNullException">
/// <paramref name="factory" />, <paramref name="action" />, <paramref name="actionStateFactory" /> und/oder
/// <paramref name="scheduler" /> sind <see langword="null" /> Referenzen.
/// </exception>
public static Task StartNewTask <T>(this TaskFactory factory,
StartNewTaskAction <T> action,
Func <TaskFactory, T> actionStateFactory,
CancellationToken cancellationToken,
TaskCreationOptions creationOptions,
TaskScheduler scheduler)
{
if (factory == null)
{
throw new ArgumentNullException("factory");
}
if (action == null)
{
throw new ArgumentNullException("action");
}
if (actionStateFactory == null)
{
throw new ArgumentNullException("actionStateFactory");
}
if (scheduler == null)
{
throw new ArgumentNullException("scheduler");
}
return(factory.StartNew(
action:
(state) =>
{
var s = (StartNewTaskState <T>)state;
s.Invoke();
},
state: new StartNewTaskState <T>(taskFactory: factory,
action: action,
actionStateFactory: actionStateFactory,
cancellationToken: cancellationToken),
cancellationToken: cancellationToken,
creationOptions: creationOptions,
scheduler: scheduler));
}
